{"full_name":"ExTV/Podroid","owner":"ExTV","name":"Podroid","shard":"1","url":"https://github.com/ExTV/Podroid","description":"A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.","homepage":"https://extv.github.io/Podroid/","topics":["android-app","linux","shell","virtual-machine","android-virtualization-framework"],"tag_pages":["android-app","linux","shell","virtual-machine"],"language":"Kotlin","license":"GPL-2.0","avatar":"https://avatars.githubusercontent.com/u/102330270?u=4f1cbc8baf1924b36b704aa9344dfb0324de2dc4&v=4","created_at":"2026-03-16T01:04:26Z","pushed_at":"2026-11-09T23:20:12Z","metrics":{"stars":3857,"forks":265,"watchers":28,"issues":99,"prs":16,"releases":30,"issues_open":23,"issues_closed":76,"prs_open":0,"prs_closed":5,"prs_merged":11,"discussions":5},"growth":{"day":{"stars":9,"forks":0,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[3821,3830,3832,3840,3848,3857],"forks":[263,263,263,265,265,265],"watchers":[27,27,27,27,28,28],"issues_open":[21,22,22,23,23,23],"prs_open":[0,0,0,0,0,0]},"boards":{},"same_owner":[],"issues":[{"number":29,"title":"[Bug] VM exits on boot with AVF backend on Pixel 8a","comments":27,"created_at":"2026-05-19T00:57:31Z"},{"number":62,"title":"Device compatibility list (add yours)","comments":16,"created_at":"2026-07-29T01:01:14Z"},{"number":43,"title":"AVF Backend: Any plans for USB passthrough support and network issue fix?","comments":9,"created_at":"2026-06-16T15:52:25Z"},{"number":93,"title":"[Bug] 使用wifi时提示bad address。","comments":3,"created_at":"2026-09-18T06:38:36Z"},{"number":112,"title":"[Feature] Feature Request: Kindly Consider Adding ARM32 (ARMv7) Device Support","comments":2,"created_at":"2026-10-21T20:12:55Z"},{"number":85,"title":"USB Wi-Fi Adapter Passthrough Fails with Invalid ep0 maxpacket: 64 on Xiaomi (MIUI / Android 10) Devices","comments":2,"created_at":"2026-08-29T15:23:34Z"},{"number":121,"title":"[Advice] If your Android storage shows Podroid consuming a ton of storage when you have actually deleted stuff, then do this...","comments":1,"created_at":"2026-11-13T16:04:50Z"},{"number":120,"title":"[Feature]  update notification with github apk source.","comments":1,"created_at":"2026-11-12T12:53:49Z"}],"discussions":[{"number":115,"title":"Compile QMI driver into the kernel (CONFIG_USB_NET_QMI_WWAN=y)","comments":0,"category":"Ideas","created_at":"2026-11-03T03:51:11Z"},{"number":102,"title":"AVF performance","comments":0,"category":"General","created_at":"2026-09-25T16:37:48Z"},{"number":74,"title":"How to add custom drivers","comments":1,"category":"Q&A","created_at":"2026-08-03T15:25:47Z"},{"number":50,"title":"Enable Android Binder (binderfs) for Waydroid Support ⭐⭐⭐⭐⭐","comments":2,"category":"Ideas","created_at":"2026-07-11T17:14:23Z"},{"number":49,"title":"Multiple Container","comments":1,"category":"Ideas","created_at":"2026-07-03T08:31:33Z"}],"latest_release":{"name":"v1.3.0","tag":"v1.3.0","published_at":"2026-11-09T23:02:28Z","body":"## A third backend: User-Mode Linux (experimental)\n\nUntil 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).\n\nUML is opt-in. **Auto never picks it**, and AVF stays the best choice on phones that have it. It is aimed at everyone else.\n\n### Measured speed\n\nNothing Phone (1), Android 15, no AVF. Same release build, same VM disk, 4 CPUs, 2 GB RAM. Median of three runs.\n\n| Test | QEMU | UML | Change |\n|---|---|---|---|\n| Boot to Ready | 33 to 41 s | 13 to 18 s | about 2.5x faster |\n| `npm install express` (warm cache) | 49.5 s | 24.8 s | 2.0x faster |\n| `npm install express` (cold cache, one run) | 70.7 s | 34.5 s | 2.0x faster |\n| Node.js CPU loop (300M iterations) | 18.8 s | 4.7 s | 4.0x faster |\n| `docker run` with a shell loop inside | 19.7 s | 7.4 s | 2.7x faster |\n| `apk add nodejs npm` (one run, includes download) | 21.2 s | 12.4 s | 1.7x faster |\n| `npm --version` | 7.3 s | 4.6 s | 1.6x faster |\n| `docker run --rm alpine true` (container start only) | 7.6 s | 8.2 s | no gain |\n\nPixel 10 Pro XL, Android 17, same test on all three backends:\n\n| Test | QEMU | UML | AVF |\n|---|---|---|---|\n| Boot to Ready | 44 s | 36 s | 10 s |\n| `npm install express` (warm cache) | 25.7 s | 20.6 s | 1.9 s |\n| Node.js CPU loop | 10.5 s | 3.4 s | 0.9 s |\n| `docker run` with a shell loop inside | 12.8 s | 8.9 s | 1.2 s |\n| `docker run --rm alpine true` | 9.1 s | 8.4 s | 0.85 s |\n\nWhat the numbers say: work that computes gains the most, package installs gain about 2x, and starting a container is not faster. On a fast phone the gap to QEMU narrows, and AVF is roughly ten times faster than either. If your phone has AVF, keep using it. These are measurements from two phones, not a promise for yours.\n\n### How to try it\n\n1. Stop the VM.\n2. Open **Settings**, tap **Show advanced**, and under **Backend** pick **UML (experimental)**.\n3. Start the VM. The first start runs a short compatibility test (a few seconds, needs a network connection), then boots.\n4. Check that it took: the home screen now has a **Backend** row that should read **UML (user-mode)**, and `uname -r` in the terminal prints a different kernel than before.\n5. Run what you normally run. Your containers, packages and files are the same disk on every backend, so you can switch back and forth without losing anything.\n\nTo go back, stop the VM and pick **Auto**.\n\nIf the compatibility test fails, or UML crashes or does not finish booting within two minutes, Podroid switches UML off on that phone and starts the VM on the backend Auto would have used, with a notification. Settings then shows the reason and a **Try UML again** button.\n\n### What is different on UML\n\n- **No USB passthrough.** That still needs the QEMU backend.\n- **Every process in the VM is a real Android process.** On Android 12 and later the system limits how many child processes apps may have, so a container-heavy workload can lose processes. On Android 14 and later, turn on **Developer options > Disable child process restrictions**. On Android 12 and 13, see the troubleshooting section of the guide.\n- **It is not a security boundary.** The guest kernel runs with the app's own privileges. The Downloads share is restricted to the Downloads folder, but do not run untrusted code in UML expecting VM-grade isolation.\n- **Stopping takes longer**, about 15 to 30 seconds for a clean shutdown.\n- The guest network interface is `vec0` instead of `eth0`. Addresses, port forwards and SSH on 9922 behave as on QEMU.\n- The APK grows by about 13 MB.\n\n### Reports wanted\n\nUML was tested on two phones. If you try it, a report helps a lot, whether it worked or not: phone model, Android version, what you ran, and the file from ","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}