proot-distro Complete Guide—Install Any Linux Distro in Termux (2026)

proot-distro Complete Guide — Install Any Linux Distro in Termux (2026)

📅 March 12, 2026 👤 Rixon Xavier ⏱ 18 min read 📝 4,000+ words

🆓 Free 🤖 No Root Required 📱 Android ✅ Tested 2026

// Table of Contents

Introduction — What is proot-distro?
Getting Started — Prerequisites & Termux Setup
Installing proot-distro in Termux
Installing Linux Distros with proot-distro
Using Your Linux Distro Inside Termux
Advanced proot-distro Tricks & Customization
Common Errors and Fixes
Pro Tips
Distro Comparison Table
Frequently Asked Questions
Conclusion

// 01 — Introduction: What is proot-distro?

If you've been using Termux for a while, you've probably wondered: can I run a full Linux distribution directly on my Android phone without rooting it? The answer is a resounding yes — and the tool that makes it possible is called proot-distro. In this complete guide, you'll learn everything you need to know about proot-distro in Termux, from installation to advanced usage, all without requiring root access on your Android device.

proot-distro is an official Termux package that acts as a wrapper around proot — a user-space implementation of chroot. In plain English, it tricks a Linux distribution into thinking it's running on real hardware, even though it's running inside your Android phone's Termux environment. This means you can install Ubuntu, Debian, Kali Linux, Alpine, Fedora, Arch Linux, and many more full Linux distros on your phone, completely free and without root.

Why does this matter? Think about it — your Android phone is a powerful Linux-based computer sitting in your pocket. With proot-distro in Termux, you can turn it into a portable cybersecurity workstation, a Python development environment, a web server, or a full Kali Linux hacking lab. You get access to real package managers like apt, dnf, and pacman. You get real bash environments. You get real Linux tools — all running on your phone.

I've been running Kali Linux and Ubuntu inside Termux via proot-distro for years, and I can say with confidence that this is one of the most powerful setups you can build on Android. Whether you're a cybersecurity student, a developer, or just a Linux enthusiast, proot-distro unlocks the full potential of your Android device. In this guide, we'll cover every step from scratch, explain every command, and show you example outputs so you know exactly what to expect.

💡

Tip: proot-distro runs entirely in user space — no root, no unlocking bootloader, no risk to your Android system. It's the safest way to run Linux on Android.

// 02 — Getting Started: Prerequisites & Termux Setup

Before we install proot-distro, we need to make sure your Termux environment is properly set up. Skipping this step is the number one reason people run into errors later, so follow every step carefully.

What You Need

An Android device running Android 7.0 (Nougat) or higher
At least 2GB of free storage (4GB+ recommended if installing Kali or Ubuntu)
A stable internet connection (Wi-Fi recommended for downloads)
Termux installed from F-Droid — NOT the Play Store version

⚠️

Warning: Do NOT use the Play Store version of Termux. It is outdated and abandoned. Always download Termux from F-Droid (f-droid.org) for the latest, fully functional version.

Step 1 — Update Termux Packages

Once Termux is open, the very first thing you should always do is update and upgrade all packages. This ensures you have the latest versions of everything before installing new tools.

Update the package list

This command fetches the latest list of available packages from Termux repositories.

bash copy

pkg update

Upgrade all installed packages

When prompted with "Do you want to continue? [Y/n]", type Y and press Enter.

bash copy

pkg upgrade

You'll see a lot of text scrolling by as packages download and install. This is completely normal. Wait until it finishes and returns you to the $ prompt.

Step 2 — Grant Storage Permission

If you want your Linux distro to be able to access your phone's storage (photos, downloads, etc.), grant storage permission to Termux now:

bash copy

termux-setup-storage

A permission dialog will appear on your screen. Tap Allow. After this, your phone's storage will be accessible at ~/storage/ inside Termux.

✅

Your Termux environment is now ready! Time to install proot-distro.

// 03 — Installing proot-distro in Termux

Installing proot-distro in Termux is one of the simplest things you'll ever do. Since proot-distro is an official Termux package maintained by the Termux team, you don't need to add any external repositories or deal with complicated dependencies. A single command is all it takes.

Install the proot-distro Package

Install proot-distro using pkg

Run this command and confirm with Y when asked.

bash copy

pkg install proot-distro

Expected output (you'll see something similar):

output copy

Checking availability of current mirror:
[*] https://packages.termux.dev/apt/termux-main: ok
Reading package lists... Done
Building dependency tree... Done
The following NEW packages will be installed:
  proot proot-distro
0 upgraded, 2 newly installed, 0 to remove and 0 not upgraded.
Do you want to continue? [Y/n] Y
...
Setting up proot-distro (4.x.x) ...

Verify the Installation

After installation completes, verify that proot-distro is working correctly by checking its version and listing all available distros:

bash copy

proot-distro --version

bash copy

proot-distro list

The list command will show you all officially supported Linux distributions that you can install directly through proot-distro. As of 2026, this includes:

output copy

Supported distributions:
  alpine        - Alpine Linux 3.x
  arch          - Arch Linux
  blackarch     - BlackArch Linux
  debian        - Debian 12 (Bookworm)
  deepin        - Deepin
  fedora        - Fedora 39
  gentoo        - Gentoo Linux
  kali          - Kali Linux (Rolling)
  manjaro       - Manjaro Linux
  nethunter     - Kali NetHunter
  openkylin     - OpenKylin
  opensuse      - OpenSUSE
  pardus        - Pardus
  ubuntu        - Ubuntu 24.04 LTS
  ubuntu-lts    - Ubuntu 22.04 LTS
  void          - Void Linux

💡

Tip: The list changes over time as the Termux team adds new distros. Run proot-distro list any time to see the current supported distros.

// 04 — Installing Linux Distros with proot-distro

Now comes the exciting part — actually installing a full Linux distribution on your Android device. In this section, we'll walk through installing the most popular options: Ubuntu, Kali Linux, and Alpine Linux. The process is nearly identical for all distros, so once you learn the pattern, you can install any distro from the list.

Installing Ubuntu in Termux

Ubuntu is a great starting point for beginners. It has the largest community, the most documentation, and the most compatible software ecosystem via apt. Here's how to install it:

Install Ubuntu 24.04 LTS

This will download the Ubuntu rootfs (~150MB compressed). Wait patiently — it extracts to around 500MB.

bash copy

proot-distro install ubuntu

Log into Ubuntu

After installation completes, launch Ubuntu with this command.

bash copy

proot-distro login ubuntu

You'll notice your prompt changes to something like root@localhost:~# — you're now inside Ubuntu running on your Android phone! Let's update it:

bash copy

apt update && apt upgrade -y

Installing Kali Linux in Termux

Kali Linux is the go-to distribution for cybersecurity professionals and ethical hacking students. With proot-distro in Termux, you can install Kali Linux on your Android phone and access hundreds of penetration testing tools — no root required.

⚠️

Warning: Kali Linux tools are intended for ethical hacking and penetration testing on systems you own or have explicit permission to test. Using them without authorization is illegal. Always practice on your own lab devices.

bash copy

proot-distro install kali

bash copy

proot-distro login kali

Once inside Kali, update the package list and install the full kali-linux-default metapackage (or install individual tools as needed):

bash copy

apt update
apt install kali-linux-default -y

💡

Tip: The kali-linux-default metapackage installs hundreds of tools and requires 3–5GB of space. If you're limited on storage, install individual tools like nmap, nikto, or hydra instead.

Installing Alpine Linux in Termux

Alpine Linux is a minimal, security-focused distribution that's perfect if you're low on storage or just want a lightweight Linux environment. It's tiny (under 10MB download) and extremely fast.

bash copy

proot-distro install alpine

bash copy

proot-distro login alpine

Alpine uses apk as its package manager instead of apt:

bash copy

apk update
apk upgrade

// 05 — Using Your Linux Distro Inside Termux

Now that you have a full Linux distro running inside Termux via proot-distro, let's explore how to actually use it effectively. This section covers day-to-day usage patterns, installing software, managing your distro, and switching between multiple distros.

Installing Software Inside Your Distro

Once you're logged into your distro, you can install any software that's available in its repositories. Here are some examples for each distro type:

Ubuntu / Debian / Kali (uses apt):

bash copy

# Install Python 3, pip, git, curl, wget, and nmap
apt install -y python3 python3-pip git curl wget nmap

# Install a web server
apt install -y apache2

# Install Node.js
apt install -y nodejs npm

Alpine (uses apk):

bash copy

apk add python3 py3-pip git curl nmap

Arch / Manjaro (uses pacman):

bash copy

pacman -Syu
pacman -S python git curl nmap

Running Commands Without Logging In

One very useful proot-distro feature is the ability to run a single command inside a distro without fully logging into it. This is great for scripts and automation:

bash copy

# Run a command in ubuntu without logging in
proot-distro login ubuntu -- python3 --version

# Run a script inside kali
proot-distro login kali -- bash /path/to/script.sh

Managing Multiple Distros

One of the best features of proot-distro is that you can install and run multiple Linux distributions at the same time. Each distro is fully isolated from the others. Here's how to manage them:

bash copy

# List all installed distros
proot-distro list

# Login to a specific distro
proot-distro login ubuntu
proot-distro login kali

# Remove a distro (frees up storage)
proot-distro remove ubuntu

# Reset a distro (reinstalls from scratch)
proot-distro reset kali

Accessing Termux Storage from Inside the Distro

You can access your Termux home directory and your phone's storage from inside your Linux distro. When you log in, your Termux home is automatically accessible. To access phone storage, use the --shared-tmp flag or bind mount manually:

bash copy

# Log in and bind the Termux home directory
proot-distro login ubuntu --bind /sdcard:/mnt/sdcard

# Now inside Ubuntu, access your phone storage at:
ls /mnt/sdcard/

✅

You can now share files between your Termux environment, your phone storage, and your Linux distro seamlessly!

// 06 — Advanced proot-distro Tricks & Customization

Once you're comfortable with the basics of proot-distro in Termux, it's time to level up. This section covers advanced techniques including creating custom login aliases, setting up a desktop environment, using SSH, creating backups of your distro, and more.

Create Login Aliases for Faster Access

Typing proot-distro login kali every time gets tedious. Add aliases to your Termux ~/.bashrc or ~/.zshrc file for one-command access:

bash copy

# Add to ~/.bashrc (run this from Termux, not inside the distro)
echo "alias kali='proot-distro login kali'" >> ~/.bashrc
echo "alias ubuntu='proot-distro login ubuntu'" >> ~/.bashrc
echo "alias alpine='proot-distro login alpine'" >> ~/.bashrc

# Apply changes
source ~/.bashrc

# Now you can just type:
kali
ubuntu

Setting Up a Desktop Environment (GUI)

Yes — you can run a full graphical desktop environment inside proot-distro! This requires a VNC viewer app. Here's how to set up XFCE4 (lightweight and fast) inside Ubuntu:

Install VNC server and XFCE4 inside Ubuntu

Log into Ubuntu first, then run these commands.

bash copy

# Inside Ubuntu proot environment
apt update
apt install -y xfce4 xfce4-terminal tightvncserver dbus-x11

Install a VNC viewer on your Android

Download AVNC or bVNC from F-Droid, or VNC Viewer from the Play Store.

Start the VNC server inside Ubuntu

Set a VNC password when prompted, then start the server.

bash copy

vncserver :1 -geometry 1280x720 -depth 24

Connect with your VNC viewer

Open your VNC viewer app and connect to localhost:5901 with the password you set.

Backup and Restore Your proot-distro

You've spent hours setting up your perfect Kali or Ubuntu environment. Don't lose it — back it up! proot-distro has built-in backup and restore commands:

bash copy

# Backup your Ubuntu distro to a tar.xz file
proot-distro backup ubuntu --output ~/ubuntu-backup.tar.xz

# Restore from backup
proot-distro restore ~/ubuntu-backup.tar.xz

Login as a Specific User

By default, proot-distro logs you in as root. You can create a regular user and log in as that user instead:

bash copy

# Inside your distro, create a new user
adduser hydrauser

# Back in Termux, login as that user
proot-distro login ubuntu --user hydrauser

Setting Up SSH Inside proot-distro

You can run an OpenSSH server inside your proot-distro and connect to it from another device on your network. This turns your phone into a remote Linux server:

bash copy

# Inside Ubuntu
apt install -y openssh-server

# Edit SSH config to allow root login (for testing only)
sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin yes/' /etc/ssh/sshd_config

# Set a root password
passwd

# Start SSH (use a port above 1024 — no root needed)
/usr/sbin/sshd -p 8022

# From another device on the same network:
# ssh root@YOUR_PHONE_IP -p 8022

// 07 — Common Errors and Fixes

Even with a well-tested tool like proot-distro in Termux, you'll occasionally run into errors. Here are the most common ones and exactly how to fix them.

Error 1: "Unable to connect to packages.termux.dev"

output copy

Err:1 https://packages.termux.dev/apt/termux-main stable InRelease
  Unable to connect to packages.termux.dev

Fix: This is a network issue. Try switching from mobile data to Wi-Fi (or vice versa). If that doesn't work, change the Termux mirror:

bash copy

termux-change-repo

Error 2: "Failed to run command '/proc/self/exe'"

Fix: This usually means you're using the old Play Store version of Termux. Uninstall it and install from F-Droid. If you're already on F-Droid Termux, try:

bash copy

pkg reinstall proot proot-distro

Error 3: "proot: sysvipc not supported"

Some Android kernels don't support certain Linux kernel features. This error is harmless and can usually be ignored — your distro will still work fine. If it causes specific tools to fail, try Alpine Linux instead, which has fewer kernel dependencies.

Error 4: apt hangs or freezes inside proot

Fix: Kill the current session (press Volume Down + C in Termux), log back into your distro, and try:

bash copy

rm /var/lib/dpkg/lock-frontend
rm /var/lib/apt/lists/lock
dpkg --configure -a
apt update

Error 5: "No space left on device"

Fix: You've run out of phone storage. Free up space by removing unused distros:

bash copy

# See how much space each distro uses
du -sh ~/storage/proot-distro/*

# Remove a distro to free space
proot-distro remove ubuntu

// 08 — Pro Tips

💡

Tip 1 — Use tmux for multi-session management: Install tmux in Termux (pkg install tmux) to run multiple terminal sessions side-by-side. Run Kali in one pane, Ubuntu in another, and keep a Termux session open in a third.

💡

Tip 2 — Install zsh for a better shell experience: Inside your distro, run apt install zsh and install Oh My Zsh for a vastly improved terminal experience with autocomplete and syntax highlighting.

💡

Tip 3 — Keep your distros lightweight: Avoid installing full desktop environments unless you specifically need GUI. A headless distro uses far less RAM and runs faster on mobile hardware.

💡

Tip 4 — Use a Bluetooth keyboard: Termux + proot-distro on a large phone or tablet with a Bluetooth keyboard is a genuinely usable mobile Linux workstation. Pair it with hydratermux.blogspot.com tutorials and you'll learn Linux faster than ever.

💡

Tip 5 — Update proot-distro regularly: The Termux team regularly adds new distros and fixes bugs. Keep proot-distro updated with pkg upgrade proot-distro.

💡

Tip 6 — Enable wake lock: Go to Termux notification → tap "Acquire wakelock" to prevent Android from killing your Termux and proot sessions when the screen turns off. Essential for long-running tasks.

// 09 — Linux Distro Comparison Table

Not sure which distro to install? Here's a quick comparison of the most popular proot-distro options to help you choose:

Distro	Size	Package Manager	Best For	Difficulty
Ubuntu 24.04	~500MB	apt	Beginners, Development	⭐ Easy
Kali Linux	~1–5GB	apt	Cybersecurity, Ethical Hacking	⭐⭐ Medium
Alpine Linux	~10MB	apk	Lightweight, Minimal	⭐⭐ Medium
Debian 12	~400MB	apt	Stability, Servers	⭐ Easy
Arch Linux	~200MB	pacman	Advanced Users, Customization	⭐⭐⭐ Hard
Fedora	~600MB	dnf	Modern packages, Development	⭐⭐ Medium
BlackArch	~500MB+	pacman	Security Research, Hacking Tools	⭐⭐⭐ Hard
Void Linux	~200MB	xbps	Rolling release, Minimalism	⭐⭐ Medium

// 10 — Frequently Asked Questions

Does proot-distro require root access on Android?

No — this is one of proot-distro's biggest advantages. It runs entirely in user space using proot, which emulates a chroot environment without needing kernel-level root permissions. You can install and use any supported Linux distro on a completely stock, unrooted Android device.

Can I run Kali Linux tools like Metasploit inside proot-distro?

Yes, most Kali Linux tools work inside proot-distro in Termux. Tools like nmap, hydra, nikto, sqlmap, and many others work perfectly. Some tools that require specific kernel modules (like aircrack-ng for monitor mode) may not work without a modified kernel, but the vast majority of command-line pentesting tools function correctly. Always use these tools only on networks and systems you own or have explicit permission to test.

How many Linux distros can I have installed at the same time?

There is no hard limit set by proot-distro — you can install as many distros as your storage allows. Each distro is stored as a separate directory inside Termux's home directory. The only practical limit is your phone's available storage space. Keep in mind that Ubuntu uses ~500MB, Kali can use 1–5GB depending on what you install, and Alpine uses under 50MB.

Is proot-distro the same as a virtual machine?

Not exactly. A virtual machine (VM) emulates an entirely separate computer with its own virtual hardware. proot-distro uses proot to create an isolated file system environment where a Linux distro can run, sharing the actual Android device's hardware (CPU, RAM) directly. This means proot-distro is faster and more efficient than a VM because there is no hardware emulation overhead. However, it also means some kernel-level features may not be available.

Can I run graphical apps (GUI) with proot-distro?

Yes! You can run GUI applications by setting up a VNC server inside your proot-distro environment and connecting to it with a VNC viewer app on your Android device. Popular options include setting up XFCE4 or LXDE desktop environments inside Ubuntu or Kali, then viewing them through apps like AVNC. See the advanced section of this guide for step-by-step instructions.

What happens to my proot-distro if I uninstall Termux?

If you uninstall Termux, all your proot-distro installations will be permanently deleted because they are stored inside Termux's private app directory. Always back up important distros using the proot-distro backup command before uninstalling or reinstalling Termux. You can store the backup file on your phone's SD card or internal storage for safekeeping.

How do I update proot-distro itself?

Update proot-distro from Termux (not from inside the distro) using the standard Termux package manager command: pkg upgrade proot-distro. This updates the proot-distro tool itself. To update packages inside your Linux distro (e.g., Ubuntu), log into the distro and run apt update && apt upgrade -y as you normally would on any Linux system.

// 11 — Conclusion

And there you have it — a complete guide to proot-distro in Termux, covering everything from installation to advanced tricks like desktop environments, SSH servers, backups, and multi-distro management. You now have the knowledge to turn your Android phone into a powerful, portable Linux workstation — completely free and without rooting your device.

proot-distro is genuinely one of the most impressive tools in the Termux ecosystem. The fact that you can install a full Kali Linux or Ubuntu environment on your phone in minutes, access hundreds of cybersecurity tools, run real package managers, and even spin up a VNC desktop — all without root — is remarkable. Rixon Xavier and the entire Hydra Termux community use this setup daily, and it never gets old.

Whether your goal is to learn Linux, study for cybersecurity certifications, build and test applications, or just explore what's possible on Android, proot-distro in Termux is your gateway. Start with Ubuntu if you're a beginner, move to Kali when you're ready to explore ethical hacking, and experiment with Alpine or Arch as your skills grow.

✅

Your next step: Open Termux right now and run pkg install proot-distro followed by proot-distro install ubuntu. Your Linux journey on Android starts today!

If you found this guide helpful, share it with a friend who's curious about Linux on Android. And if you run into any issues not covered here, drop a comment below — the Hydra Termux community is always here to help. Check out our other tutorials for more Termux guides, cybersecurity tools, and Android Linux tips.

💡

Related Reading: Check out our guide on "How to Use Nmap in Termux" and "How to Set Up SSH in Termux" to continue your Linux on Android journey after setting up proot-distro.

Rixon Xavier

Founder — HYDRA TERMUX

Cybersecurity educator and Termux enthusiast. Creating free tutorials to help Android users learn Linux and ethical cybersecurity since 2023.

⚠️ Disclaimer: This tutorial is for educational purposes only. Always practice on systems you own or have explicit permission to test. HYDRA TERMUX does not support illegal activity of any kind.

--- BLOGGER SETTINGS FOR THIS POST: Title: proot-distro Complete Guide — Install Any Linux Distro in Termux (2026) Labels: termux, linux, android, Termux Tutorial, No Root, Kali Linux, Ethical Hacking, android tools Search Description: Learn how to use proot-distro in Termux to install Ubuntu, Kali Linux & more on Android — no root required. Full 2026 guide by Hydra Termux. Custom Robot Tags: all, noodp ---