Chroot Distro

Install Linux distributions on Android devices using chroot

---

Warning

• Root access is required
• Back up important files before use

---

Requirements

• Rooted Android Device
• Install the latest BusyBox for Android NDK by osm0sis as a Magisk module (Recommended: v1.36.1)

Tip

If you use KernelSU then there's no need to flash the busybox-ndk module, it already has builtin busybox support

---

Supported Distributions

• Debian
• Ubuntu
• Fedora
• Arch Linux
• Kali Linux

---

Quick Start

# List available distributions
chroot-distro list

# Install a distribution
chroot-distro install debian

# Login to the distribution
chroot-distro login debian

---

Command Reference

Command	Aliases	Description
help	--help, -h, he, hel	Display help information
version	--version, -v	Show version information
list	li, ls	List available distributions
install	i, in, ins, add	Install a distribution
login	sh	Enter distribution shell
remove	rm	Remove a distribution
unmount	umount, um	Unmount distribution
clear-cache	clear, cl	Clear downloaded files

---

Commands

help

Display general help or command-specific help information:

chroot-distro help
chroot-distro <command> --help

list

List all available distributions with their aliases, installation status, and additional information:

chroot-distro list

install <distro>

Install a supported distribution:

chroot-distro install debian

login <distro>

Enter a shell session inside the installed distribution:

chroot-distro login debian

Available Options

• --user <username> – Login as a specified user (user must exist in chroot environment)
• --termux-home – Mount Termux home directory inside chroot
• --bind <host_path>:<chroot_path> – Bind mount a path from host to chroot
• --work-dir <path> – Set custom working directory (default: user's home directory)

Execute Commands

Run commands directly inside the chroot environment:

chroot-distro login debian -- /bin/sh -c 'apt update'

Use -- to separate chroot-distro options from the target command.

unmount <distro>

Unmount all mount points associated with a distribution:

chroot-distro unmount debian

Options

• --help – Display help for this command

Examples

chroot-distro unmount debian

remove <distro>

Permanently remove an installed distribution.

Warning

This operation is irreversible and does not prompt for confirmation.

chroot-distro remove fedora

clear-cache

Remove all downloaded rootfs archives to free up storage space:

chroot-distro clear-cache

---

Termux Integration

To simplify usage from Termux, create a wrapper script:

1. Open Termux and run:

nano $PREFIX/bin/chroot-distro

2. Paste the following content:

#!/data/data/com.termux/files/usr/bin/bash

args=""
for arg in "$@"; do
    escaped_arg=$(printf '%s' "$arg" | sed "s/'/'\\\\''/g")
    args="$args '$escaped_arg'"
done

su -c "/system/bin/chroot-distro $args"

3. Make the script executable:

chmod +x $PREFIX/bin/chroot-distro

• You can now use chroot-distro directly from Termux without switching to root user manually.

---

Support the Project

If you find this project helpful and would like to support its development, consider buying me a coffee! Your support helps maintain and improve this project.

Cryptocurrency Donations:

• USDT (BEP20,ERC20): 0x1d216cf986d95491a479ffe5415dff18dded7e71
• USDT (TRC20): TCjRKPLG4BgNdHibt2yeAwgaBZVB4JoPaD
• BTC: 13Q7xf3qZ9xH81rS2gev8N4vD92L9wYiKH
• DOGE: DJkMCnBAFG14TV3BqZKmbbjD8Pi1zKLLG6
• ETH: 0x1d216cf986d95491a479ffe5415dff18dded7e71

Every contribution, no matter how small, helps keep this project alive and growing! ❤️

---

License

This project is licensed under the GNU General Public License v3.0.

Acknowledgments

This project builds upon the work of:

• proot-distro
• Magisk-Modules-Alt-Repo/chroot-distro

---

⭐ If you enjoy this project, consider giving it a star!