How to install an OS with Andronix?

These instructions assume that you have Andronix version 6.0 or beyond installed on your device.
This is not a guide to install a Modded OS . Please read the next article from this for more information on that.

Installing your favorite distro is a breeze with Andronix. Please follow these simple steps mentioned below-

  • After you open the Andronix app, you will have a catalog of logos of the distributions you can use on your device. Select the distribution you want to install.

  • An information page will now open up. It mentions the size of the distro before extraction, the ease of use of the distro, the current version of the distro, and a button labeled as Proceed. Click the button to Proceed.

  • Click "Install" on the sheet that appears from the bottom.

  • After the previous step, a page would ask you for the GUI you would like to see.

  • You can choose a Desktop Environment if you would like to use your mouse as well as your keyboard, or you've

little or no experience with Linux. More informationhere.

  • You can choose a Window Manager if you only want to use your keyboard to manage Windows and other OS-level tasks. These are pretty light and fast but do require some skill before getting productive. More

information here.

  • If you don't want a Graphical User-interface, you can go ahead with the Command Line Interface. You'll have

a terminal, which is enough if you know what you're doing in your session.

If you're confused in choosing one option, we would always recommend you to go with a Desktop Manager.

Based on your selection, please follow one of these following articles-

Desktop Environment

Now that you've decided to go ahead with a desktop environment, let's select what desktop environment you would like to install. You can read this page of the documentation to know more about different DE and then click on the one you would like to install.

Window Manager

Window Managers it is. Now select what Window Manager you would like to install. You can read this part of the documentation for more information on window managers.


Since you've chosen the Command Line Interface, there's no extra configuration required on your part. You may proceed to the instructions below.

We are close to being done with the selections in the Andronix app. The following screen should be the screen displaying on your device right now if you have correctly followed all the instructions.

Andronix app has copied a command to your clipboard automatically.


You will need to run/execute this command in Termux.

Please read this before proceeding to make sure that you're using a compatible version of Termux for the installation process. Make sure that you've followed this guide for Migration to F-Droid
  • Open the termux app and run the following command first pkg update, this will ensure that you are running the latest packages. Now long press to paste the copied command and then hit enter to run it.

  • The installation/downloading will take some time. Please leave the termux app running.

    Please read this article to disable battery optimization for Termux so that processes running inside Termux don't randomly terminate.

  • You can now start the distro by typing the following command in termux (Please choose your distro and execute the respective command)-

    • Ubuntu 18 ./
    • Ubuntu 20 ./
    • Debian ./
    • Manjaro ./
    • Arch Linux ./
    • Fedora ./
    • Void ./
    • Alpine ./
    • Kali Linux ./
  • If you see [email protected] in the shell, you have successfully started your distro.

  • Lastly, you need to start the VNC server actually to display the distro. Follow the steps mentioned here.