andronix.docs

Installing Modded OS

Step-by-step guide to installing an Andronix Modded OS on Android, from purchase and the Termux install command to user setup and VNC.

Docs for Andronix app 8.x (Classic)

You are reading docs for Andronix app 8.x. Update to app 10 for the new installer: Start here.

Installing a Modded OS is straightforward. This guide walks you through selecting and installing your distro, running the install command in Termux, setting up your user account, and connecting to the desktop. Prefer video? Watch the walkthrough below, then follow the steps.

Each account is allotted a set number of downloads per day and per month. The limit is generous and most users will never hit it, but we can always help you raise it for a valid use case. It exists strictly to curb abuse of the download system. You can see this limit on the OS information page of each distribution.

With that out of the way, let's install the distro.

1. Preparation 🚀

Open the app

Open the Andronix app and tap the Modded OS button on the dashboard. The Modded OS section lists all the distros you can install.


image

Select the distro

Tap the distro you already own or want to buy. If you haven't bought it before, the app shows its price and other details so you can complete the purchase. Once the purchase is done, continue with the next steps.

Unpaid Screen


image

Paid Screen


image

Continue

The distro is now linked to your profile, so you can move on to installing it.

2. Selection ⭐️

Install

You'll see three buttons: Install, Uninstall, and Download Quota.


image

Finalize

Tap Install to start installing the distro.

3. Termux Execution 📥

This is where the actual installation of your Linux distribution happens.

The Andronix app has automatically copied an install command to your clipboard.

image

Termux

You'll run this command in Termux to download and set up the distro.

Before you continue, make sure you're using a compatible version of Termux. If you haven't already, follow the Migrating Termux to F-Droid guide.

Paste

Open the Termux app, long press to paste the copied command, then press Enter to run it.


image

Wait

The download and installation will take a while. Keep the Termux app running until it finishes.

Disable battery optimization for Termux so that processes running inside it don't get terminated at random.
Download speeds for the distro tar file may seem unusually low. This is expected: the file is extracted while it downloads, which slows the process down.

Command Executed

Back in Andronix, tap the Command Executed button at the bottom of the screen. This tells the app the command has been run.

Finish

Once the script has finished successfully, tap the Execution Finished button at the bottom.


image

4. Starting Distribution ⚡️

If the installation completed without any errors at the end, you've reached the last part: configuring your installed distro. First, you need to start the distro.

Start Command

Start the distro by running the command for your distro in Termux:

  • Ubuntu XFCE
./start-andronix.sh
  • Ubuntu KDE
./start-androkde.sh
  • Debian XFCE
./start-androdebian.sh
  • Manjaro XFCE
./start-androjaro.sh

This starts the post-installation process, which sets up the essential packages. Wait until it finishes.

Select Region

If the post-installation setup succeeds, you'll see a menu for selecting your region. Use the arrow keys, as shown in the screenshot below, to move the selection, then press Enter to continue.


image

Select City

After selecting your region, choose your City in the next menu and continue.


image

Select Keyboard

Select your keyboard layout if you use something other than the default English layout. In this example we keep the English layout, so press Enter to continue.


image

Username

If everything went well, you'll see a blue screen asking for a username. Enter any username that isn't a reserved keyword like admin, root, etc. (your name works fine), then press Enter to continue.

If you can't bring up your keyboard to enter the username, press the ESC key at the bottom. This restarts the script. This time, make sure your keyboard is open (tap anywhere on the terminal) while you're in the Termux shell.

image

Password

Next, set a password for your user. It can be anything longer than six characters. Press Enter, re-enter the password to confirm it, and press Enter again to continue.


image

Root Password

Now set a root password. It can be anything longer than six characters. Press Enter, re-enter the root password to confirm it, and press Enter again to continue.

Confirm

The next screen shows everything you entered. Check that the username and passwords are correct (if not, press ESC or the back button to restart the script), then press Enter to continue.


image

Wait

Wait while the system creates your user. You should see something like this during setup.


image

5. VNC Configuration 📺

That's it! Once user creation finishes, you'll see {your_username}@localhost:~$.

VNC Start

The Start VNC server page should now be open in the Andronix app.


image

VNC Server

To interact with your distro's graphical interface, set up a VNC server. Follow the VNC Basics guide to set one up and connect to your distro.

Seeing the Process completed (signal 9) - press Enter error in Termux? Read Android 12 and Newer to fix it.

Next steps

Modded OS

Andronix Modded OS are paid, performance-tuned Linux distros with themes and essential software preinstalled, so you can skip setup and start working.

Desktop Environments

Learn what a desktop environment is, which ones Andronix offers for each distro, and which one to pick if you're just getting started.

On this page

1. Preparation 🚀Open the appSelect the distroContinue2. Selection ⭐️InstallFinalize3. Termux Execution 📥TermuxPasteWaitCommand ExecutedFinish4. Starting Distribution ⚡️Start CommandSelect RegionSelect CitySelect KeyboardUsernamePasswordRoot PasswordConfirmWait5. VNC Configuration 📺VNC StartVNC ServerNext steps