Documentation

Every guide for Droidspaces, the Linux container runtime for Android and Linux.

Basics

  • Android installation: Install Droidspaces on a rooted Android device: install the APK, let the app set up the backend, and create a Linux container without typing a terminal command.
  • Linux installation: Install Droidspaces on a Linux desktop or server: download the tarball, install the binary, build a rootfs image and boot the first container.

Guides

  • Feature deep dives: How each Droidspaces feature works: namespace isolation, init system support, OverlayFS volatile mode, GPU acceleration, cgroup isolation, seccomp shields, and Android-specific tuning.
  • Display, audio & desktop: GPU acceleration, PulseAudio sound and desktop environment auto-boot for Droidspaces containers on Android and Linux.
  • Kernel configuration: How to compile an Android kernel with Droidspaces support: the config options and patches for non-GKI and GKI kernels.
  • Android app usage: Using the Droidspaces Android app: managing containers, networking, stats, the terminal and kernel settings.
  • Linux CLI: Reference for the droidspaces command line: every command, flag and config file key.
  • Networking from zero: Every networking concept behind Droidspaces gateway mode, from the start: IP addresses, LAN, WAN, DHCP, DNS, NAT, bridges, veth pairs, network namespaces and OpenWRT.

Recipes

  • Cool things you can do: Two recipes: a mobile server behind Tailscale, UFW and Fail2Ban, and Docker running nested inside a Droidspaces container.

Reference

  • Troubleshooting: Fixes for common Droidspaces container problems: systemd hangs, paranoid networking, SELinux corruption, OverlayFS on f2fs, sparse image reclaim, Wi-Fi power save.
  • Community-supported devices: Android devices that community members have run Droidspaces on, with kernel sources and downloads.
  • Nix/NixOS: Run NixOS in Droidspaces containers: build a tarball, import the compatibility module, and try the experimental Finix system.
  • Uninstallation: Remove Droidspaces from Android and Linux: containers, backend data, the APK and system files.

Edit this page on GitHub