Updating

Updating AXP.OS

Via the integrated Updater (recommended)

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 the recovery to sideload an update 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
4. IMPORTANT: before actually installing (on non-A/B devices) or at latest before rebooting (on A/B devices) you should unhide Magisk if it is currently hidden!*

The process of an OTA will validate the download before it offers to actually start an installation. That means you can install updates only if the downloaded zip is not tampered and only when it is signed by a known and valid signature (i.e. signed by an AXP.OS key which must be also valid for this device). If the signature is invalid or the file is corrupt you will see a warning in the Updater app, you cannot install the update and the downloaded file gets removed automatically.

Important

*) If you don't it is possible that the system gets confused and the Magisk icon disappears after the update. If that happens:

• try a reboot
• 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)
• then install the official Magisk apk and hide it 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.

Manual update

Via Updater

Note: during the local update process the zip validation happens identically as written above.

1. download the latest release for your device (for Pixels: choose "OS zip")
2. open Android Settings -> Updater -> 3 dots menu -> Local update and select the downloaded zip
3. follow the instructions and ensure you do not miss the hint above regarding Magisk

Via ADB / recovery

Note: as long as you use the recommended AXP.OS recovery and not a custom recovery it will also check for a valid signature and if the zip is tampered or not. This is one of the reasons why the AXP.OS recovery is highly recommended and should be used always.

1. download the latest release for your device (for Pixels: choose "OS zip")
2. reboot your device into recovery and select Apply update -> Apply from ADB
3. use adb sideload AXP.OS.zip to flash the update

Via fastboot (last resort)

Warning

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

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

If there is a factory zip for your device available you can use this one to flash it via fastboot like described in the Installation guide of your device but beware:

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

If there is a need for a flashable one without factory reset let us know.