ravindu644/Droidspaces-OSS: +45 stars this week

Rank of ravindu644/Droidspaces-OSS in each topic for today, this week and this month
Topic	Today	This week	This month
DevOps	–	#49of 117	#73of 269
Kotlin	–	#84of 114	#88of 167
Android	–	#130of 207	#167of 342

Droidspaces

Droidspaces runs full Linux distributions as containers on a rooted Android phone or a Linux PC. Each container boots its own init system, whether systemd, OpenRC or any other, on the host's kernel.

There is no emulation and no virtual machine, so programs run at native speed. One static binary under 400 KB does all of it, and the Android app drives that binary so you never need a terminal to get started.

What you get

A real Linux system, not a chroot, not a virtual machine. Ubuntu, Debian, Fedora, Arch, Alpine, NixOS, OpenWrt and more boot with their own init as PID 1. Services, timers, reboot from inside the container, all of it works.
Networking that works out of the box. NAT mode gives every container its own address and internet, with no setup. Gateway mode hands a container's LAN to an OpenWrt container that does DHCP, DNS and firewalling. Macvlan puts a container straight on a wired LAN with its own address from your router.
A desktop on your phone. Anland or Termux:X11 for the display, VirGL or Qualcomm's Turnip for the GPU, and PulseAudio for sound, all started for you. Turn on the toggles, start the container, and the desktop environment appears with sound.
Hardware when you want it. GPU, USB, sensors and block devices can be exposed to a container with one toggle. Docker and Podman run inside containers on every supported kernel.
Containers that stay up. On Android a container can start at boot, before you unlock the phone, and keeps running for months, whether the app is open, closed or uninstalled. Everything lives in /data/local/Droidspaces.
The same binary on Linux. Every feature of the CLI works the same on a Linux PC. Packages are built for aarch64, armhf, x86_64, x86 and riscv64.

Requirements

Android

A rooted device. KernelSU is recommended. Magisk and APatch work too.
A kernel built with the options Droidspaces needs. Most stock kernels lack them. See the kernel configuration guide, or pick a phone from the community-supported devices list, which links to ready-made kernels.
Kernel 3.10 or newer. 4.9 and newer is where most distributions work well.

Linux

Kernel 3.10 or newer and root. Any current desktop distribution has everything else. Run sudo ./droidspaces check to confirm.

Get started

Android

Install the APK from the latest release, grant root, open it, and let it install the backend. Reboot when it asks.
Open the Containers tab, tap +, then Repository. Pick a distribution, tap Download, then Install, and walk through the setup.
Tap Start. Open the Panel tab and tap Terminal to get a shell.

The Android installation guide covers each step in detail.

Linux

The Linux installation guide shows how to install Droidspaces, where to get a rootfs and how to put it in an image file.

Screenshots

Home

Containers

Panel

Security

Warning

Droidspaces is a privileged container runtime.

Root inside a container is powerful, and a hostile root process can reach the host.

Do not run code you do not trust in a container, and use a normal user with sudo for daily work, as you would on any Linux machine.

Hardware access and privileged mode relax the remaining barriers further, so turn them on only when you need them.

Documentation

Everything below is also on the documentation site, rendered and searchable.

Page	What it covers
Android installation	From a rooted phone to a running container, in the app.
Linux installation	Installing the binary and preparing a rootfs on a PC.
Android app guide	Every screen in the app and what it does.
Container settings	Each toggle and flag: what it does and when to use it.
Linux CLI	Every command, flag and config file key.
Networking from zero	How the network modes work, from IP addresses up to an OpenWrt gateway.
Display, audio and desktop	GPU acceleration, sound and a desktop environment on Android and Linux.
Anland	A Wayland desktop on Android through the Anland app, for KDE Plasma and other Wayland compositors.
Kernel configuration	Building an Android kernel with Droidspaces support.
Recipes	A phone as a home server with Tailscale, Docker inside a container, and more.
Troubleshooting	Symptoms, causes and fixes.
Community-supported devices	Phones known to run Droidspaces, with kernel sources.
NixOS	Building and configuring a NixOS container.
Uninstallation	Removing Droidspaces from Android or Linux.

Community and contributing

Questions and help: the Telegram channel. Bugs and feature requests: GitHub issues.

Code contributions start with CONTRIBUTING.md. App translations are on Weblate:

Credits

LXC, the architectural inspiration.
BusyBox, the static binary the app uses for extraction and setup (our build).
ReTerminal, Termux and LXC-Manager, the terminal emulator backend.
JetBrains Mono, the monospace typeface in the app, under the SIL Open Font License 1.1.