ExTV /Podroid

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

★ 3,857⑂ 265👁 28⑃ 16● 99▤ 30
KotlinGPL-2.0Created 2026-03-16extv.github.io/Podroid/
Download: v1.3.0v1.3.0 ↓1.3.02026-11-09
+9
Daily
3,857
stars
265
forks
28
watchers
16
prs
99
issues
30
releases

README

Podroid

Run Linux containers and a full Linux desktop on your Android phone. No root.

A real Alpine Linux VM with its own kernel - not a chroot or proot trick - so Podman, Docker and LXC behave exactly like they do on a server.





!Android 8+
!arm64

Website · Documentation · Download APK


  
    Home
    Running
    Terminal
    Themes & fonts
  




 What you get

- Podman, Docker and LXC - pre-installed, ready the moment it boots
- A real VM - Alpine Linux on a custom kernel via QEMU, or hardware-accelerated AVF on supported pKVM devices; an experimental, opt-in UML backend (no USB passthrough yet) runs the guest kernel as a plain process and is selectable in Settings
- In-app terminal - full xterm-256color, 122 color themes, 13 fonts, live resize
- X11 desktop - run GUI Linux apps in a built-in viewer with touch, keyboard, mouse and audio
- USB passthrough, SSH, port forwarding and a guest-to-Android bridge
- Container backup, a live VM/device status view and Downloads-folder sharing with the guest
- English and 中文, no root, any arm64 device on Android 8+

 Quick start

1. Download the APK and install it.
2. Tap Start VM, wait for Ready!, open the terminal.

sh
 rootless containers, straight away
podman run --rm alpine echo "hello from a container"
docker run -d -p 8080:80 nginx

 expose that container to your phone and LAN, right from the VM shell
podroid-forward add 8080 8080 tcp      TCP or UDP, on every backend
curl http://:8080
podroid-forward clean                  remove every rule you added, in one go

 SSH in from your laptop (enable SSH in the setup wizard or Settings)
ssh root@ -p 9922         password: podroid

 read this documentation with no network connection
podroid-forward add 9980 9980 tcp      forward the docs port to the phone
podroid-docs                           serves docs/guide at http://127.0.0.1:9980


Setup, the backends, networking, the X11 viewer and troubleshooting all live in the documentation.

 Build

sh
git clone https://github.com/ExTV/Podroid.git
cd Podroid
./build-all.sh all      kernel, rootfs, QEMU and APK (needs Docker + Android SDK/NDK)


Per-component builds and toolchain details: CONTRIBUTING.md.

 Contributing

Contributions of every size are welcome: bug reports, kernel-config tweaks, new themes, UI polish, X11 input fixes, anything.

- Pull requests: read CONTRIBUTING.md first. Keep changes scoped, run ./build-all.sh test before pushing, and explain why in the PR description.
- Bug reports: open an issue with your device and Android version, a short repro, and the diagnostic log (Settings → Export Diagnostic Log in the app).

 Related projects

RikkaHub Agent is a fork of RikkaHub, the native Android LLM chat client, that turns it into a real on-device agent: 80+ device tools, scheduled jobs, an AI-driven browser, a Linux workspace, SSH, screen automation and a remote Telegram bot, all opt-in. Its SSH tool can log into a running Podroid VM (localhost:9922), so an agent on your phone can 

Top issues

Discussions

Latest release

v1.3.0 v1.3.0 2026-11-09
A third backend: User-Mode Linux (experimental)

Until now a phone without hardware virtualization had one option: QEMU, which emulates every guest CPU instruction in software. This release adds UML, which runs the guest Linux kernel as an ordinary Android process, so guest code runs directly on the CPU. It needs no root, no adb grant and no special permission, and it works on any arm64 phone with Android 8 or later (107, 111).

UML is opt-in. Auto never picks it, and AVF stays the best choice on phones that have it. It is aimed at everyone else.

 Measured speed

Nothing Phone (1), Android 15

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON