Skip to content

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

docs: note the root-based hardware-virtualization alternative for protected-only devices

ExTv8bfa28f13c62
diff --git a/docs/guide/backends.html b/docs/guide/backends.html
index 2b0b459..fa1b13f 100644
--- a/docs/guide/backends.html
+++ b/docs/guide/backends.html
@@ -98,6 +98,11 @@
<p>Condition (4) is the non-obvious one. pKVM can operate in two modes: <em>protected</em> (guest memory is encrypted and the host cannot inspect it) and <em>non-protected</em>. Podroid's guest image is a standard Alpine Linux squashfs - it does not meet the signing and measurement requirements for protected VMs. A device that only advertises protected VM support cannot run Podroid's image under AVF, so Auto falls back to QEMU on such devices.</p>
+ <div class="callout note">
+ <span class="label">Protected-only device and want hardware speed? You'll need root.</span>
+ <p>If your device only supports protected VMs, AVF cannot run Podroid's custom kernel and there is no app-side workaround: the protected-VM firmware (pvmfw) only boots payloads that carry a signed, verified boot image, which a general-purpose Linux kernel does not. The only remaining route to hardware virtualization is to open the hypervisor device node (<code>/dev/kvm</code>, or <code>/dev/gunyah</code> on Qualcomm SoCs) directly, which requires <strong>root</strong>. Podroid is deliberately no-root, so it uses QEMU on these devices. If you are rooted and on a recent Qualcomm Snapdragon device (8 Gen 3 / SM8650 or newer with Gunyah enabled), a separate, unaffiliated project, <a href="https://github.com/Droid-VM/DroidVM" target="_blank" rel="noopener">DroidVM</a>, runs VMs through the Gunyah hypervisor or KVM for near-native speed.</p>
+ </div>
+
<h2>Differences between backends</h2>
<table>
diff --git a/docs/guide/performance.html b/docs/guide/performance.html
index dfbb831..9456026 100644
--- a/docs/guide/performance.html
+++ b/docs/guide/performance.html
@@ -135,6 +135,8 @@
<h2>What won't help without root</h2>
<p>Some common Linux performance tricks are simply unavailable on a stock Android device: <code>io_uring</code> is blocked by Android 12+ seccomp policy; CPU affinity (<code>taskset</code>) requires elevated scheduling permissions; KSM memory deduplication is a kernel knob; huge pages on the host are not user-configurable; TAP networking requires a TUN/TAP device. These are hard limits, not oversights.</p>
+ <p>Full hardware virtualization (KVM, or Qualcomm's Gunyah) is in the same category for the QEMU path: opening the hypervisor device node directly requires <strong>root</strong>, and on AVF it is gated to devices that allow non-protected pKVM (see <a href="backends.html">Backends</a>). Podroid stays no-root by design. If you are rooted on a recent Qualcomm Snapdragon device, a separate project such as <a href="https://github.com/Droid-VM/DroidVM" target="_blank" rel="noopener">DroidVM</a> uses Gunyah or KVM for near-native VMs; Podroid does not require root and uses QEMU or AVF instead.</p>
+
<div class="callout tip">
<span class="label">Biggest wins</span>
<p>If you have a Pixel 8, 9, or 10 (or another device shipping pKVM), switch the backend to <strong>AVF</strong> in Settings &rarr; Advanced. AVF runs the guest on real hardware CPU cores via the kernel hypervisor - no TCG, no double-JIT overhead, no cold-cache process-spawn cost. See <a href="backends.html">Backends: QEMU &amp; AVF</a> for setup. For heavy workloads on any backend, also raise RAM in Settings and lower the X11 viewer resolution if you are running a desktop.</p>