Install Debian Linux on Android Using Termux & Proot – No Root Required

Before you start

Running a full Linux distro inside Android consumes storage and RAM. Make sure you have at least 2 GB of free internal storage and a device that stays above 50 % charge during the installation. A stable Wi‑Fi connection is required to download packages.

• Backup important data – the process does not modify system partitions, but it creates large files in /data/data/com.termux/files.
• Enable Developer options (Settings > About phone > Tap Build number 7 times) – not strictly required but handy for ADB debugging later.
• Install a file manager that can show hidden files (e.g., Amaze) – useful for inspecting the Debian rootfs.

Step 1: Install Termux

After the initial setup you should see a $ prompt. This is the Linux shell provided by Termux.

Step 2: Update Termux packages

When the command finishes you have a clean, up‑to‑date environment ready for Proot.

Step 3: Install the Debian distribution via proot‑distro

After installation you can verify the presence of the rootfs folder using ls ~/.local/share/proot-distro/installed.

Step 4: Launch the Debian environment

At this point you have a fully functional Debian system. It runs in user space, so no root privileges on the Android side are required.

Step 5: Basic Debian configuration

Using a non‑root user prevents accidental changes to the container’s system files and mirrors the typical Linux workflow.

Step 6: Access Android files from Debian

Termux automatically mounts your shared storage at /storage/emulated/0. Inside Debian this path is visible as /root/storage/emulated/0 (or /home/androiduser/storage/emulated/0 if you created a user). You can create a symbolic link for convenience:

ln -s /root/storage/emulated/0 ~/android_storage

Now ~/android_storage points to your phone’s internal storage, allowing you to edit scripts, read documents, or compile code directly from the Debian shell.

Step 7: Optional – Install a lightweight GUI with VNC

Debian is headless by default. If you need a graphical interface (e.g., to run a text editor with mouse support), follow these steps.

1. Install a minimal X server and a VNC server:

   apt install -y xfce4 xfce4-terminal tightvncserver

2. Set a VNC password (you’ll be prompted): vncpasswd.
3. Create a startup script ~/.vnc/xstartup with the following content:

   #!/bin/sh
   xrdb $HOME/.Xresources
   startxfce4 &

   Make it executable: chmod +x ~/.vnc/xstartup.
4. Start the VNC server on display :1: vncserver :1 -geometry 1280x720 -depth 24.
5. On the Android side, install a VNC client app (e.g., VNC Viewer). Connect to localhost:5901. You should see the XFCE desktop.

When you are done, stop the server with vncserver -kill :1. Remember that the GUI consumes additional RAM, so close it when not in use.

Step 8: Persisting the environment across reboots

Termux stores the Debian rootfs in its private data directory, which survives device reboots. However, the container is not automatically started. To launch Debian with a single tap you can create a Termux widget or shortcut:

1. Open Termux and run termux-create-package (optional) or simply create a script file ~/start-debian.sh containing:

   #!/data/data/com.termux/files/usr/bin/bash
   proot-distro login debian

2. Make the script executable: chmod +x ~/start-debian.sh.
3. Long‑press the home screen, choose Widgets, select the Termux widget, and place it. When prompted, choose start-debian.sh. Tapping the widget now opens the Debian shell directly.

Troubleshooting

What you can do next

• Install development stacks such as python3, nodejs, or golang directly inside Debian.
• Use ssh to access the container from another computer: apt install openssh-server and forward port 2222 via Termux’s sshd.
• Run Docker‑compatible tools like podman (experimental) for container workloads.

With a full Debian environment on your Android device you now have a portable, scriptable Linux workstation that works on any phone or tablet without rooting.