Downloading updates

Downloading an update takes very long. Why?

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

The download seems to be stuck. What should I do?

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.

Can I verify if the downloaded update is authentic?

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

How can I install 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.

I can't find the "Local upgrade" option. Where is it located?

OxygenOS 12 onwards, local upgrade needs extra steps. On some devices, you need to enable Android's built-in developer options: Settings -> About device -> Version and tap Build number 7 times. If it still doesn't show up in the usual place, you'll need to install a separate app: https://oxygenos.oneplus.net/English_20220225101104.apk (source). Find it in your app drawer after installing, it should be labelled “System update”. Note: in case the local upgrade app downloads as a ZIP, replace the “.zip” at the end with “.apk” in your file manager. Also, make sure you've enabled "Install unknown apps" for whatever app you're opening the local upgrade APK from. Find this in Settings -> Apps & notifications -> Special app access -> Install unknown apps. We recommend granting this permission only to very few applications, e.g. just the file manager or your browser.

Automatic update installation (ROOT)

How can I install updates automatically?

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.

Is the "Automatic install" option safe to use?

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.

Which recovery software is compatible with Automatic install?

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.

Do I need to select a root package?

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.

During installation, my device gets stuck with a series of buttons on its screen. What happened?

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

The update changelog screen (system settings) is empty after i've installed an update using Oxygen Updater. What's going wrong?

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.

Can I install / update Oxygen ROM (Gingerbread) with this app?

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.

Does this app support my (non-OnePlus) phone?

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

Can I root my device with this 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.

Can I install a custom ROM on my device with this app?

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.

Is there an ad-free version of this app?

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

I'd like to have a new feature available in the app. Can I send a request?

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 10 Pro (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren, 8, 8T, N10, N100, 9, 9 Pro and N200 sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus Nord N200 (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren, 8, 8T, N10, N100, 9 and 9 Pro sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus 9 Pro (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren, 8, 8T, N10, N100 and 9 sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus 9 (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren, 8, 8T, N10 and N100 sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus Nord N10 (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren, 8 and 8T sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus Nord N10 (Metro by T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren, 8 and 8T sold by T-Mobile, it is not possible to install any updates retrieved from another source than Metro by T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus Nord N100 (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren, 8 and 8T sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus Nord N100 (Metro by T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren, 8 and 8T sold by T-Mobile, it is not possible to install any updates retrieved from another source than Metro by T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus 8T (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T, 7T Pro 5G McLaren and 8 sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus 8 (Sprint and T-Mobile USA editions)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T and 7T Pro 5G McLaren sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus 8 (Verizon USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro, 7T and 7T Pro 5G McLaren sold by T-Mobile, it is not possible to install any updates retrieved from another source than Verizon. Therefore it is not possible to offer updates for this device in the app.

OnePlus 7T Pro 5G Mc Laren (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T, 7 Pro and 7T sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus 7T (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as OnePlus 6T and 7 Pro sold by T-Mobile, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus 7 Pro 5G (Sprint USA edition)

Why is this device not supported by Oxygen Updater?

In the same way as T-Mobile variants of OnePlus 6T and 7 Pro it is not possible to install any updates retrieved from another source than Sprint. Therefore it is not possible to offer updates for this device in the app.

OnePlus 7 Pro (T-Mobile USA Edition)

Why is this device not supported by Oxygen Updater?

On this device, as same as on 6T T-Mobile variant, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

OnePlus 6T (T-Mobile USA edition)

Why is this device not supported by Oxygen Updater?

On this device, it is not possible to install any updates retrieved from another source than T-Mobile. Therefore it is not possible to offer updates for this device in the app.

I am seeing a message about the device being unsupported. What's going on?

The device was supported in the app for a short while. However, the Oxygen Updater administrators found out that you can't install updates on it. Therefore, we've decided to drop support effective January 29th, 2019.

OnePlus 3

I can't find the "Local upgrade" option. Where is it located?

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

I can't find the "Install from SD" option. Where did it go?

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.

Why is there no Android 7.0 "Nougat" update available for the OnePlus X?

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

When will Android 7.0 "Nougat" come to the 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

Can I install OxygenOS if I'm currently using Cyanogen OS?

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)

Why is there no Marshmallow or Nougat update for the 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".