Frequently Asked Questions

Downloading updates

Unfortunately, this issue has been affecting multiple users of the app since August 2018.
It's currently not known what's causing it and we are trying to fix it ASAP.

To get your update, download it from another site / source and then install it the same way as you normally do using the app.

The download servers may be slow when many people download updates at the same time. Just wait patiently until the download has finished.

First, wait for a while and see if the download resumes.

If your download is still stuck after waiting 10 minutes, cancel the download and re-try to download the update again. The download server may be busy, or you might have experienced a network issue.

Oxygen updater does this automatically for you. The app server obtains the MD5 checksum of the file from OnePlus. This takes place when importing the update, right before you receive a push notification of it. When you use the app, the app obtains the MD5 checksum from the app server using a secure connection. When downloading, the file is verified using this checksum. If the file has been tampered with or was incomplete, an error will be shown and the file will be deleted from your device.

Installing updates

You can either install them by reading the installation guide (which you'll usually automatically see after downloading an update), or use automatic update installation (only if you have root access).

If you don't get an option to select automatic update installation, this means you don't have root access. See the Automatic Update installation section below for more information on this.

Automatic update installation (ROOT)

Automatic update installation makes it very easy to install an update. You'll just have to tap on Automatic installation and the app will do the rest for you.

However, this feature requires root access and TWRP recovery to work. If you don't have these, you'll not see this feature when installing an update.

If you want to root your device, please visit the OnePlus forums or the XDA-developers forums. A good starting point is to install Magisk and TWRP.

While success can never be guaranteed, the developer of the app has tried its best to ensure the update installation process is as safe as possible. But: it's still your own risk to install updates using my app.

If you face issues, contact the developer using the email address shown in the Google Play Store. I'll try to help you if possible.

You'll need a custom recovery mode to use this feature - the default one doesn't work with it.

Only TRWP recovery has currently been tested, but any recovery supporting OpenRecoveryScripting should work. By the way, TWRP recovery is the most popular custom recovery mode available.

Note: MultiRom and other boot- or kernel level modifications have NOT been tested. The update installation may fail if you use one of these.

It is highly reccommended to select a root package you want to have installed, as you'll otherwise lose root access and TWRP recovery (thus: also the ability to auto install updates using this app) while installing the update. If you did not choose a root package, the only way to re-gain root access is to flash TWRP recovery again, and afterwards flashing the package again.

This means an error occurred when installing the update. If you want to see what happened, you'll have to press the menu-like button in the bottom right of your screen (in the navigation bar). Then, the log file of the recovery mode will be shown on your screen.

Look for the red lines. Usually, these tell you what went wrong.

Other questions

Normally, when your phone gets an update, it stores a copy of the changelog of the update, so you can view it after you've installed it.

However, if you update using Oxygen updater, you'll likely upgrade before you got the regular system update notification.
Therefore, your phone has no way to save a copy of the changelog and it will be empty after having installed the update through Oxygen Updater.

However, there is a solution: The changelog is also available in Oxygen Updater!
To view it, open Oxygen Updater. You'll see a screen telling that "your system is up to date". Now, tap on "view update information" and you'll see the change log on your screen.

No, the old Oxygen ROM has nothing to do with OnePlus and OxygenOS.

Therefore, it is not possible to update devices running the legacy Oxygen ROM using Oxygen updater.

This app only supports the OnePlus phones listed at the website and in the settings of the app.

No, you cannot root your device with this app.
In order to root your device, you'll have to unlock the bootloader of your device, install a custom recovery and flash a root package yourself.

No, you cannot install a custom ROM on your device using this app. Please make sure the bootloader of your device is unlocked and you have a custom Recovery mode installed. Afterwards, visit the Development section of the OnePlus forums to download and install a custom ROM yourself.

You can remove the ads via a one-time purchase. You can purchase the ad-free upgrade within the settings screen of the app.

While the developer of Oxygen Updater does not have much time to develop new features for the app, you may always send a feature request in an email to the developer.

OnePlus 3

This happens if you are using OxygenOS 3.2.8 or older. In that case, you'll need to either have TWRP recovery installed on your OnePlus 3, or update to a later version of OxygenOS using the standard System Updates app of your device. Afterwards, you can install updates using this option

OnePlus X

The option has been named "Install from local" and might be incorrectly phrased in the install guide in older versions of Oxygen Updater. Update to the latest version of Oxygen Updater to obtain the correct update installation instructions.

The processor of the OnePlus X does not meet Google's requirements to run Android 7.0 "Nougat". This means no "Nougat" version of OxygenOS for the OnePlus X can be released.

OnePlus 2

-- June 28th, 2017 --
OnePlus stated the update will *NOT* be released anymore. They have insufficient resources for developing the update as well as for maintaining their newer devices.

-- May 29th, 2017 --
The chances of the Nougat update still getting released are very slim. In terms of software updates, it seems like OnePlus is focusing only on its newer products.

-- Original --
OnePlus has announced that their team is working on an OxygenOS version based on Android 7.0 "Nougat" for the OnePlus 2, but they didn't announce when it will be released.

OnePlus One

Unfortunately, you can't easily install OxygenOS if you are running Cyanogen OS. To do so, you'll have to use a computer. You can follow the official installation guide from OnePlus here: OxygenOS install guide (for OnePlus One)

OxygenOS for the OnePlus One was a beta version offered to the community.

It was released to the public to gather feedback and tips for improving it. This feedback was used by the OnePlus developers to create a better version of OxygenOS to ship on the newer OnePlus devices.

Now that OnePlus has multiple phones running OxygenOS, their team has no time to maintain the version for the OnePlus One. If you want to run a newer Android version, stick to Cyanogen OS or flash a custom ROM.

Nougat will never come officially to the OnePlus One, as the processor does not meet Google's requirements for Android 7.0 "Nougat".


Oxygen Updater
An app to download system updates for OxygenOS devices faster. Requires a OnePlus device running OxygenOS.
Developed by: Arjan Vlek