Skip to content

How It Works

Under-the-hood explanations of Beetroot's design decisions.

In this section

  • Architecture — one bundled compose template, project-per-instance isolation, Magisk stealth via direct DB writes.
  • Binder & run-modes — the binder capability ladder (host → loadable module → vm+KVM → vm+TCG) and the beetroot modes decision logic that picks a rung for the current host.
  • Boot Flow — how Android init, stealth.rc, and entrypoint.sh connect; why there's no Docker ENTRYPOINT.
  • Boot Scripts — per-helper contracts for the three POSIX shell scripts entrypoint.sh sources at boot.
  • Filesystem Layout — what lives where in an instance dir, in the user XDG dirs, and inside the wheel.