Upgrading from an Older Modded OS

You installed a Modded OS with an older Andronix app (8.x or earlier) and want the new version? This page takes you through it in five steps: check what you have, back up your files, uninstall the old version, install the new one, and bring your files back.

1. Check which one you haveCopy Anchor Link

Open Termux and run:

ls ~

Old Modded OS log you in as root; Andronix 2.0 logs you in as your own user. Free distros from the old app (folders like ~/ubuntu-fs) are covered in Installs from before Andronix 2.0.

2. Back up your filesCopy Anchor Link

Uninstalling deletes everything inside the old Modded OS, so copy your files to your phone's storage first. In Termux:

termux-setup-storage

Allow the storage permission when Android asks. Then set OLD to the folder name from step 1 (andronix, androkde, androdeb or androjaro) and pack the home folders into one file in your phone's Download folder:

OLD=androkde
cd ~/$OLD-fs && tar -czf /sdcard/Download/$OLD-home.tar.gz root $(ls -d home 2>/dev/null)

This saves /root (where the old Modded OS kept your files) and /home, if there is one. Check the file is there: ls -lh /sdcard/Download/$OLD-home.tar.gz. Programs you installed aren't saved; you install them again in the new version.

3. Uninstall the old versionCopy Anchor Link

Pick one way:

With the andronix command (installer 2.0.1 or newer). It deletes the old folder, its -binds folder and its start script, and nothing else:

It shows what it will delete, with the sizes, and asks first.

If Termux says andronix: command not found, get the command first (this installs only andronix, no distro), then run the line from the table:

(curl -fsSL --retry 4 --retry-delay 3 https://dl.andronix.app/get.sh -o $PREFIX/tmp/get.sh || curl -4 -fsSL --retry 2 --retry-delay 3 https://dl.andronix.app/get.sh -o $PREFIX/tmp/get.sh) && sh $PREFIX/tmp/get.sh

In the app (10.0 or newer): on the Modded OS tab, touch and hold your edition under Archived — yours to keep. The app copies the same command; paste it into Termux.

By hand, with the folder name from step 1 (OLD=androkde as above):

chmod -R u+w ~/$OLD-fs; rm -rf ~/$OLD-fs ~/$OLD-binds ~/start-$OLD.sh

Removing a Modded OS from Andronix 2.0Copy Anchor Link

For a Modded OS you installed with Andronix 2.0, use its edition id, for example andronix remove ubuntu-kde. See Remove a Modded OS. To keep its files, back it up first with andronix backup ubuntu-kde --to storage (Back up and restore).

4. Install the new versionCopy Anchor Link

In the Andronix app, open the Modded OS tab and pick:

• Your old edition, rebuilt: if you bought a Modded OS before, it's under Archived — yours to keep, free. These Classic editions keep their original look, on current systems.
• Or a Modded 2.0 edition: the new lineup. See Prices.

Then follow Installing Modded OS. It takes a few taps in the app and one command in Termux, and you create your own user at the end.

5. Bring your files backCopy Anchor Link

Start the new Modded OS (for example ./start-ubuntu.sh, or open its desktop), then unpack the backup into a folder in your home:

mkdir -p ~/old-modded && tar -xzf /sdcard/Download/androkde-home.tar.gz -C ~/old-modded

Use your backup's file name. Your old files are now in ~/old-modded/root (and ~/old-modded/home). Move what you want to keep, for example mv ~/old-modded/root/Projects ~/. When you're done, delete ~/old-modded and the backup file.