linuxdeploy is an Android application that installs and runs a full GNU/Linux distribution in an isolated chroot environment on an Android device without modifying the system partition. It bootstraps a complete Linux userland from distribution repositories or rootfs archives, using a debootstrap-style package installation process adapted for Android, and stores the filesystem as a loop-mounted ext4 disk image for efficient space management and portability.
The project provides multiple ways to interact with the running Linux environment, including SSH remote access, VNC with X11 display forwarding for graphical desktop sessions, and direct framebuffer rendering for environments without a display server. It supports running ARM, x86, and MIPS binaries inside the chroot by leveraging the Android kernel's compatibility layers, and includes a statically compiled Busybox binary to minimize dependencies on the host system.
Users can launch graphical desktop environments such as LXDE, Xfce, or MATE within the chroot for a full desktop experience on a mobile device. The application is distributed as an Android package and provides a command-line interface for managing the Linux installation and container lifecycle.