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
+9
日增长
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
#29[Bug] VM exits on boot with AVF backend on Pixel 8a27 comments · 2026-05-19#62Device compatibility list (add yours)16 comments · 2026-07-29#43AVF Backend: Any plans for USB passthrough support and network issue fix?9 comments · 2026-06-16#93[Bug] 使用wifi时提示bad address。3 comments · 2026-09-18#112[Feature] Feature Request: Kindly Consider Adding ARM32 (ARMv7) Device Support2 comments · 2026-10-21#85USB Wi-Fi Adapter Passthrough Fails with Invalid ep0 maxpacket: 64 on Xiaomi (MIUI / Android 10) Devices2 comments · 2026-08-29#121[Advice] If your Android storage shows Podroid consuming a ton of storage when you have actually deleted stuff, then do this...1 comments · 2026-11-13#120[Feature] update notification with github apk source.1 comments · 2026-11-12
Discussions
#115Compile QMI driver into the kernel (CONFIG_USB_NET_QMI_WWAN=y)0 comments · 2026-11-03#102AVF performance0 comments · 2026-09-25#74How to add custom drivers1 comments · 2026-08-03#50Enable Android Binder (binderfs) for Waydroid Support ⭐⭐⭐⭐⭐2 comments · 2026-07-11#49Multiple Container1 comments · 2026-07-03
Latest release
v1.3.0 v1.3.0 2026-11-09A 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