# meefik/linuxdeploy

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/meefik-linuxdeploy).**

5,859 stars · 733 forks · Java · GPL-3.0

## Links

- GitHub: https://github.com/meefik/linuxdeploy
- Homepage: https://meefik.github.io/linuxdeploy
- awesome-repositories: https://awesome-repositories.com/repository/meefik-linuxdeploy.md

## Topics

`android` `chroot` `containers` `deployment` `linux`

## Description

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.

## Tags

### Business & Productivity Software

- [Android Chroot Environments](https://awesome-repositories.com/f/business-productivity-software/workspace-management/chrome-os-workspace-administrations/chroot-based-linux-environments/android-chroot-environments.md) — Runs a full GNU/Linux distribution in an isolated chroot on Android devices without modifying the system partition.
- [Android Chroot Runtimes](https://awesome-repositories.com/f/business-productivity-software/workspace-management/chrome-os-workspace-administrations/chroot-based-linux-environments/android-chroot-runtimes.md) — Executes the installed distribution in an isolated chroot, providing a complete Linux userland on Android. ([source](https://cdn.jsdelivr.net/gh/meefik/linuxdeploy@master/README.md))

### Development Tools & Productivity

- [Android Package Bootstrappers](https://awesome-repositories.com/f/development-tools-productivity/package-installers/bootstrap-installations/debootstrap-fallback-installations/android-package-bootstrappers.md) — Bootstraps a complete Linux distribution from repositories onto an Android device.

### Operating Systems & Systems Programming

- [Linux Distribution Bootstrapping](https://awesome-repositories.com/f/operating-systems-systems-programming/linux-distribution-bootstrapping.md) — Installs a full GNU/Linux distribution from a supported repository or rootfs archive onto an Android device. ([source](https://cdn.jsdelivr.net/gh/meefik/linuxdeploy@master/README.md))
- [Desktop Environments & UI](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-environments-ui.md) — Starts graphical desktop environments like LXDE, Xfce, or MATE within the chroot for a full desktop experience. ([source](https://cdn.jsdelivr.net/gh/meefik/linuxdeploy@master/README.md))
- [Linux Desktop Environments](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-environments-ui/linux-desktop-environments.md) — Launches graphical desktop environments like LXDE, Xfce, or MATE within the chroot on a mobile device.
- [Multi-Architecture Support](https://awesome-repositories.com/f/operating-systems-systems-programming/multi-architecture-support.md) — Supports running ARM, x86, and MIPS binaries inside the chroot via Android kernel compatibility layers.

### Graphics & Multimedia

- [Framebuffer Renderers](https://awesome-repositories.com/f/graphics-multimedia/graphics-rendering-engines/framebuffer-renderers.md) — Renders graphics directly to the Android device's framebuffer for environments without a display server.

### Networking & Communication

- [Remote Access & Control](https://awesome-repositories.com/f/networking-communication/remote-access-control.md) — Connects to the running Linux system via SSH, VNC, X11, or framebuffer for remote interaction. ([source](https://cdn.jsdelivr.net/gh/meefik/linuxdeploy@master/README.md))
- [Android Linux Remote Access](https://awesome-repositories.com/f/networking-communication/remote-access-control/pc-to-android-remote-control/android-linux-remote-access.md) — Connects to the running Linux system via SSH, VNC, X11, or framebuffer for remote command-line or graphical interaction.
- [VNC Display Forwarders](https://awesome-repositories.com/f/networking-communication/unix-domain-socket-support/tunneled-unix-socket-forwarding/ssh-tunneling-forwarders/x11-display-forwarders/vnc-display-forwarders.md) — Delivers graphical desktop sessions by forwarding X11 display over VNC to an Android client.

### Security & Cryptography

- [Secure SSH Access](https://awesome-repositories.com/f/security-cryptography/secure-ssh-access.md) — Enables secure shell access to the chroot environment by running an SSH daemon inside the container.