How to install an OS with Andronix?

These instructions assume that you have Andronix version 7.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 favourite distro is a breeze with Andronix. Please follow these simple steps mentioned below-

1. Preparation 🚀

  • After you open the Andronix app, you will find the option to install a Linux Distribution. Click the card. drawing

  • Now, you will see all the distributions that can be installed on your Android device. drawing

2. Selection ⭐️

  • Click on the distro that you would like to install.

    We recommend you to get started with Ubuntu if you are overwhelmed by the options.
  • Here comes the GUI Selection drawing

    Graphical User Interface or GUI is the visual interface that you interact with to do things in your Linux distribution.

  • You now have the option to choose among the three following options:

    1. Desktop Environment: 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 information here.
    2. Window Manager: 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
    3. Command Line Interface (CLI): 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 above, please follow the respective instructions below:

    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. drawing

    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. drawing


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

3. Termux Execution 💻

Now comes the part where the actual installation of your Linux distribution begins.

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 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.
    If the installation appears to be stuck on a certain step for an unusual time, please press the ** Enter** key to resume the execution.

  • Now, click the Command Executed button at the bottom of the screen.

  • After the script has been executed successfully, Click the Execution Finished button at the bottom. drawing

4. Starting Distribution ⚡️

If you are already in the distro shell i.e. you see [email protected] mentioned on Termux. Please skip the next section.
  • You can now start the distro by typing the following command in Termux (Please choose your distro and execute the respective command) and running it-

    • 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.

5. VNC Configuration 📺

  • Now the Start VNC server page should have opened

  • In order for you to actually interact with the installed distribution's GUI, we will need to set up a VNC server.

  • Follow this comprehensive guide to set up a VNC server and use your distro.