Documentation
User Guides
Updating
Automatic

Automatic

Tip

This is the recommended way for installing AXP.OS updates

The process of an OTA update will include validating (i.e. verifying the signature / ZIP integrity) of the downloaded file before it offers to actually start an installation.

All AXP.OS devices support OTA (Over The Air) updates so there is no need for manually downloading / flashing once you have AXP.OS running. In case of trouble you can also use one of the manual update methods though.

Updates via OTA or adb sideload will keep all your data and self-installed apps.

Here the major steps for updating your system:

  1. always watch the Changelog page for important hints and news for your device
  2. always watch the automation channel, too - major impacts will be announced here first
  3. if you don’t want to wait for the regular updater check, open Android Settings -> Updater -> Press the circled arrow to check for updates

Pro flavor users (not needed when using the Slim flavor):

  1. ⚠️
    before actually installing (on non-A/B devices) or at latest before rebooting (on A/B devices) you should undo the hiding of Magisk if it is currently hidden!*
  2. in any case ensure you understood the Magisk hints (even when not using the hide Magisk app functionality)
ℹ️

*) If you miss unhiding Magisk is possible that the Magisk icon disappears after the update.

If that happens:

  1. try a reboot
  2. if it still does not show up: ensure you remove any leftovers of the previously hidden Magisk (i.e open the App drawer and search for your previously chosen Magisk app name)
  3. then install the official Magisk apk and hide Magisk again. When downloading Magisk it is recommended to use the latest version as written in the Changelog and not simply the latest one available!

Do not (i.e. NEVER EVER) INSTALL Magisk via the “Install” button! Just the apk is enough. Anything else can lead into a non-booting system. See also this important hints.

Steps

  1. Read the Changelog!
  2. Keep an eye on the Automation channel
  3. Always do a Backup!
  4. Using Magisk hide? Undo the hiding of Magisk before upgrading
  5. Android settings -> System -> Updater
  6. Follow the process

On A/B devices the upgrade will happen in the background and you get informed when a reboot is required.
On non A/B devices the device will just prepare the installation and immediately reboot afterwards to upgrade within the recovery instead.

While it is much more convenient to use the background OTA process on A/B devices it takes quite longer (depends on device + installed apps), i.e it can easily take 20-60 mins to complete before you see the reboot prompt!

If you are in hurry you can do an upgrade in recovery as this will be much faster - while it requires a PC to sideload the package.

Last updated on
Manual