Installing Modded OS

Before you startCopy Anchor Link

• Sign in to the Andronix app. Your purchases are linked to your account.
• A 64-bit phone: Modded OS isn't available on 32-bit phones; the app tells you if yours is one.
• Termux from F-Droid, GitHub or Google Play. See Install Termux.
• One install per distro: a Modded edition is installed into the folder of the distro it's built on, so it can't sit next to the free distro of the same base, or another edition built on it. For example, Modded 2.0 Ubuntu KDE replaces the free Ubuntu. If one is already there, the install stops and tells you; to replace it, add --reinstall to the command. It asks before deleting anything, so back up what you want to keep first.
• Download limits: each account can download a Modded OS a set number of times per day and per month. Most people never reach the limit, and Premium raises it. If you need more for a good reason, contact us.

1. Pick an editionCopy Anchor Link

Open the Modded OS tab. It lists the Modded 2.0 editions, the Modded Pass and Andronix Complete. If you bought a Modded OS before Andronix 2.0, your Classic editions are listed further down, under Archived — yours to keep.

2. Buy it (if you don't own it yet)Copy Anchor Link

Tap an edition you don't own, or the Modded Pass or Andronix Complete offer. The Google Play purchase sheet opens; pay there as you would for any app. When the purchase is done, the edition shows as Owned.

Already own it? Skip to the next step.

3. Install itCopy Anchor Link

Tap your editionCopy Anchor Link

Tap an edition marked Owned. The app goes straight to the Termux step and copies the install command for you. The command includes a download token, so the app hides it on screen; tap Show full command to see it with the token masked.

Run it in TermuxCopy Anchor Link

Tap Copy and open Termux. The app copies the command again (in case you copied something else in the meantime) and opens Termux. Long-press, tap Paste, and press Enter.

If you come back to the app and the install still hasn't started after 30 seconds, the app shows Nothing happened? Paste the whole command in Termux; typing install on its own won't work.

The installer shows its steps and ticks each one off. The first run also updates Termux and can take a few minutes, so keep Termux open.

Android may ask whether Termux can keep running in the background. Tap Allow, and turn off battery optimization for Termux, so Android doesn't stop the install.

Back in the appCopy Anchor Link

Tap Next. The app waits while the install runs in Termux, then shows the result.

Create your userCopy Anchor Link

When the install finishes, Termux asks you to create your user: a username, a password, and a desktop password, the same as for a free distro (see Create your user).

4. Start the desktopCopy Anchor Link

The app moves on to Start the desktop. Open your Modded desktop full screen with Termux:X11, using the distro your edition is built on, for example:

andronix desktop debian

See Start the desktop for getting the Termux:X11 app and everything else.

Classic editionsCopy Anchor Link

The Classic editions (the original Modded Ubuntu XFCE, Ubuntu KDE, Debian and Manjaro) install the same way: tap the edition under Archived — yours to keep (it shows Owned), then follow steps 3 and 4. They're free for everyone who bought them before, and aren't sold anymore.

Remove a Modded OSCopy Anchor Link

Each edition has an id, and andronix remove takes it. Stop the desktop and exit the distro, then run in Termux, for example:

andronix remove ubuntu-kde

It deletes only that exact edition, never the free distro or another edition. If a different one is installed, it says which and deletes nothing. It shows what it will delete and asks first; add --yes to skip the question. Files in /sdcard are not touched.

For a Classic edition, --legacy also deletes the copy the old Andronix app (8.x and earlier) installed, such as ~/androkde-fs, ~/androkde-binds and ~/start-androkde.sh:

andronix remove legacy-ubuntu-kde --legacy

start, desktop, update, backup and doctor accept the edition id too, for example andronix desktop ubuntu-kde. See the andronix command for the full list.

Linux in the app (10.1)Copy Anchor Link

The edition installs inside the app:

1. Tap your edition, then install it.
2. Set up your user: enter a user name and a password, as for a free distro. Modded editions come without a user, so the app always asks.
3. The install screen shows each step. When it's done, tap Open the desktop.

The edition installs into its base distro and shows on Home under Your Linux with its base distro's name and Modded. In the app, Modded OS needs a 64-bit ARM device and a Linux kernel 4.8 or newer.

If the app says:

• That token is for another edition: go back and pick this edition again.
• Early access: Premium: this edition is in early access for Andronix Premium and Modded Pass owners.
• The download link expired: go back and start the install again.

To reinstall an edition in the app, install it again. The app asks you to confirm first, because everything inside it is deleted.