Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Clone this wiki locally
There are two ways to upgrade Maru OS.
Option 1: Do a clean install
The easiest way to upgrade is to just do a fresh install with the new version. Watch out though, this will wipe all of your data, so make sure to back up anything important!
See the Installation Guide.
Option 2: Install the update zip without a factory reset
If you have important data on your device that you would like to keep, you can flash the new version's update zip in a custom recovery like TWRP. This will only touch your system partition, so all of your data will be preserved.
Tip: Take a complete backup first!
Follow the normal update zip installation, but skip the factory reset!
Make sure you also read any Upgrade Notices in the release changelog that will point out version-specific upgrade issues and workarounds.
Known Issues with Option 2
#1)Desktop updates (
The update process will not touch Maru Desktop if it finds an existing installation. That is, any data or configuration you have saved on your desktop will be preserved after the update. Unfortunately, that means you will also miss out on any updates to the desktop system (check the releases changelog to see if there were any desktop updates).
If you can back-up all the important data/configuration from your desktop system to a safe place (the sdcard folder for example), you can just delete the desktop folder from your device and Maru will re-sync the latest version after a reboot. Here's step-by-step instructions:
Back up any important data
Reboot to recovery
$ adb reboot recovery
Open up the File Manager ("Advanced" > "File Manager")
Tap the folder management icon at the bottom right of your screen
Tap "Delete" and swipe to confirm
Tap "Reboot System"
A few minutes after reboot, Maru will sync up the new desktop image, and you can then start the desktop like usual. If you backed up any data, you can restore it at this point too.
If you have gapps installed, you will need to re-install them after the upgrade. All of your apps (and their data) will still be there, but the Play store will freak out and disappear.
Just go ahead and flash the gapps zip again, add your Google account if requested, and most of your apps should work just like before. If your app still does not start properly, you will need to uninstall and reinstall the app to fix it--this has been seen with apps like Play Music or YouTube.