Documentation
User Guides
Updating
MajorRelease

MajorRelease

ℹ️

This describes the manual process for updating AXP.OS to a new Major Release (see regular updates otherwise).

The updater app does not support automatic upgrades from one Major Release of AXP.OS to another and will block installation to any update for a different version.

The process involves factory resetting your device so you should never start without a full Backup!

In-place upgrades (i.e. keeping all your apps and settings) are not supported.

Via recovery (recommended)

ℹ️
ensure you do not miss unlocking your bootloader first (if currently locked)

Doing a Major Release Upgrade is like flashing AXP.OS the first time. That means this process will factory reset your device and you need to re-install or restore your apps from your backup.

Simply follow the regular installation guide of your device with one exception:

ℹ️
When downloading the recovery, choose the recovery image of the target major release (i.e. for AXP.OS-22.2-XXXXX.img if you plan upgrading to A15)

For the rest just follow the regular guide.

⚠️
Note for A/B devices: do NOT reboot to recovery and flash it twice. If the update cause boot issues it will switch to the other slot and so you keep a working/booting system this way.

Via fastboot

⚠️

This method skips any signature validations and will fully overwrite an existing system without any further checks (other than obvious ones like if the device is matching etc).

It is highly recommended to check if the checksum hash is valid before flashing such a fastboot or factory zip and compare it not just with the one from the download site but also from the automation channel.

Note for A/B devices: do NOT reboot to recovery and flash it twice. If the update cause boot issues it will switch to the other slot and so you keep a working/booting system this way.

ℹ️
ensure you do not miss unlocking your bootloader first (if currently locked)

fastboot.zip

ℹ️
At the release time of a Major Release a fastboot zip will be provided. There are no regular releases for fastboot zip’s so you will likely be prompted for an OTA update after you have flashed fastboot zip and booted once.

Available for most devices, except Samsung and other non-fastboot aware vendors.

⚠️
you will loose all your apps and settings as it will factory reset.
  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. Download ( Pro / Slim ) the latest release for your device and flavor (choose “Fastboot zip”)
  6. Verify the build Signature and hash sum
  7. if your bootloader is unlocked: reboot your device into recovery mode and FACTORY RESET the device
  8. if your bootloader is locked: unlock it NOW (this will factory reset the device)
  9. reboot your device into fastboot mode
  10. flash the fastboot zip:
    • fastboot update <fastboot.zip filename>
  11. boot into the system and check with the Updater if there is any OTA available (install it if there is any)
  12. if all went fine follow the device guide if there is anything left (e.g. locking the bootloader again etc)

factory.zip

⚠️
you will loose all your apps and settings as it will factory reset.

Not available for all devices, mostly for Google Pixels and Fairphone devices.

  1. Read the Changelog!
  2. Keep an eye on the Automation channel
  3. Always do a Backup!
  4. Download ( Pro / Slim ) the latest release for your device and flavor (choose “Factory zip”)
  5. Verify the build Signature and hash sum
  6. reboot your device into fastboot mode
  7. flash the Factory zip:
    • when on Windows, type: flash-all.bat
    • when on Linux, type: ./flash-all.sh
  8. boot into the system and check with the Updater if there is any OTA available (install it if there is any)
  9. if all went fine follow the device guide if there is anything left (e.g. locking the bootloader again etc)
Last updated on
AutomaticManual