Podroid README

The project's README from github.com/ExTV/Podroid. As one markdown file: README.md.

Podroid logo

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.

Release Downloads Stars License Android 8+ arm64

Website · Documentation · Download APK

Home screen before the VM starts
Home
Home screen with the VM running and network info
Running
Built-in terminal showing Alpine system info
Terminal
Terminal Quick Settings with themes and fonts
Themes & fonts

What you get

Quick start

  1. Download the APK and install it.
  2. Tap Start VM, wait for Ready!, open the terminal.
# 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 both the QEMU and AVF backends
curl http://<phone-ip>: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@<phone-ip> -p 9922        # password: podroid

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

Build

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.

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 build, run and inspect containers without you typing a command.

Credits

QEMU Machine emulation
Termux Terminal emulator engine
Alpine Linux The guest distribution

Full list in CREDITS.md.

License

GPLv2. If Podroid is useful to you, a star helps other people find it.

Podroid (ExTV/Podroid)

Searching Database…

3.6K ·GitHub
Что это?Podroid — приложение для Android без root, которое запускает на телефоне настоящую виртуальную машину с Alpine Linux, позволяя использовать Linux-контейнеры (Podman, Docker, LXC) и даже полноценные графические десктопные приложения.
Это просто эмулятор терминала или настоящая ВМ с ядром?Это настоящая ВМ, а не трюки с chroot или proot: Alpine Linux работает на собственном кастомном ядре через QEMU либо на аппаратно ускоренной AVF на устройствах с поддержкой pKVM, поэтому контейнеры ведут себя в точности как на реальном сервере.
Как его запустить?Скачайте APK и установите его, затем нажмите «Start VM» и дождитесь статуса «Ready!», прежде чем открывать встроенный терминал.
Нужен ли root или конкретная версия Android?Root не требуется; работает на любом устройстве arm64 с Android 8 или новее.
Каждый ли телефон получает аппаратное ускорение?Нет — по умолчанию ВМ работает через программно эмулируемый QEMU и переключается на более быстрый аппаратно ускоренный путь AVF только на устройствах с поддержкой pKVM.
Что уже установлено при загрузке ВМ?Podman, Docker и LXC предустановлены и готовы к работе сразу после завершения загрузки ВМ, без дополнительной настройки.
Можно запускать графические Linux-приложения или только терминал?Помимо полноценного терминала xterm-256color со 122 цветовыми темами и 13 шрифтами, Podroid включает встроенный просмотрщик X11, который отображает графические Linux-приложения с поддержкой тач-ввода, клавиатуры, мыши и звука.
Можно подключаться к ВМ по SSH или использовать USB-устройства?Да, Podroid поддерживает проброс USB, доступ по SSH, проброс портов и мост «гость–Android», а также резервное копирование контейнеров и доступ гостя к папке Downloads.
Что такое RikkaHub Agent и как он связывается с Podroid?RikkaHub Agent — это форк нативного Android-клиента чатов с LLM RikkaHub, превращённый в ИИ-агента на устройстве; его SSH-инструмент может подключаться к запущенной ВМ Podroid на localhost:9922, чтобы агент самостоятельно собирал и инспектировал контейнеры.
Creator
ExTV
Size
34 MB
Stars
3.6K
Age
7mo
Commits · 90 Days