Skip to content

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

docs(site): refresh the documentation site for v1.2.5

ExTv46404341c2e0
diff --git a/docs/guide/backends.html b/docs/guide/backends.html
index fc22c3a..1322146 100644
--- a/docs/guide/backends.html
+++ b/docs/guide/backends.html
@@ -65,7 +65,7 @@
</div>
<h2>QEMU (TCG)</h2>
- <p>The QEMU backend is the default and works on <strong>any ARM64 Android 9+ device</strong> with no setup beyond installing the app. The guest CPU is emulated in software via TCG (Tiny Code Generator). See <a href="performance.html">Performance &amp; why it's slow</a> for a full explanation of where the overhead comes from and what Podroid does to reduce it. The short version: simple workloads are 2-5x slower than native; JIT-heavy workloads (Node, JVM, compilers) are slower still because of double-JIT and cold-cache process-spawn costs.</p>
+ <p>The QEMU backend is the default and works on <strong>any ARM64 Android 8+ device</strong> with no setup beyond installing the app. The guest CPU is emulated in software via TCG (Tiny Code Generator). See <a href="performance.html">Performance &amp; why it's slow</a> for a full explanation of where the overhead comes from and what Podroid does to reduce it. The short version: simple workloads are 2-5x slower than native; JIT-heavy workloads (Node, JVM, compilers) are slower still because of double-JIT and cold-cache process-spawn costs.</p>
<p>QEMU supports both <strong>TCP and UDP port forwarding</strong>. Rules you configure in the Port Forwarding screen work for both protocols.</p>
@@ -117,7 +117,7 @@
<tbody>
<tr>
<td>Device requirement</td>
- <td>Any ARM64 Android 9+</td>
+ <td>Any ARM64 Android 8+</td>
<td>Device must ship pKVM (recent Pixels and select others)</td>
</tr>
<tr>
@@ -138,7 +138,7 @@
<tr>
<td>vCPU count</td>
<td>Configurable (1 to device core count)</td>
- <td>1 vCPU = one physical core; &gt;1 vCPU = all host cores</td>
+ <td>1 vCPU = one core; &gt;1 = all host cores, with automatic fallback to fewer if a device can't boot them all</td>
</tr>
<tr>
<td>Terminal console</td>
@@ -163,16 +163,16 @@
</tbody>
</table>
- <div class="callout warn">
- <span class="label">AVF boot failures with multiple vCPUs on some units</span>
- <p>On some units (notably certain Pixel 8 / 8a / 9 builds) the guest fails to boot under AVF when more than one vCPU is used - the all-cores topology trips secondary-CPU bringup early in boot on those hypervisors, before any console output appears. Podroid now detects an AVF guest that fails to boot and offers in-app recovery: <strong>Use 1 core</strong> - which boots successfully on the affected units - or <strong>Switch to QEMU</strong>. You can also set CPU cores to 1 in Settings &rarr; Advanced beforehand. QEMU (TCG) remains the reliable fallback on all devices. See <a href="limitations.html">Limitations &amp; troubleshooting</a> for the current status.</p>
+ <div class="callout note">
+ <span class="label">Multi-core AVF and automatic fallback</span>
+ <p>On some units (notably Tensor G3/G4 Pixels - 8 / 8a / 8 Pro and the 9 series) the all-cores topology trips secondary-CPU bringup early in boot, before any console output appears. As of v1.2.5 this is handled automatically: AVF starts with the cores you chose, and if the VM resets during boot Podroid retries with fewer cores and remembers the highest count that boots on your device - no action needed. The manual <strong>Use 1 core</strong> and <strong>Switch to QEMU</strong> options remain as fallbacks, and QEMU (TCG) is reliable on all devices. See <a href="limitations.html">Limitations &amp; troubleshooting</a>.</p>
</div>
<div class="pagenav">
<a class="prev" href="performance.html"><span class="dir">Previous</span>&larr; Performance</a>
<a class="next" href="networking.html"><span class="dir">Next</span>Networking &amp; ports &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/desktop.html b/docs/guide/desktop.html
index 0d47b3f..122f983 100644
--- a/docs/guide/desktop.html
+++ b/docs/guide/desktop.html
@@ -150,7 +150,7 @@
<a class="prev" href="packages.html"><span class="dir">Previous</span>← Packages &amp; services</a>
<a class="next" href="settings.html"><span class="dir">Next</span>Terminal &amp; settings →</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/getting-started.html b/docs/guide/getting-started.html
index d2571d0..81e6cb0 100644
--- a/docs/guide/getting-started.html
+++ b/docs/guide/getting-started.html
@@ -61,7 +61,7 @@
<div class="callout note">
<span class="label">Requirements</span>
- <p>ARM64 (arm64-v8a) only. Android 9 (API 28) or newer. The APK will not install on 32-bit or x86 devices.</p>
+ <p>ARM64 (arm64-v8a) only. Android 8 (API 26) or newer. The APK will not install on 32-bit or x86 devices.</p>
</div>
<h2>Setup wizard</h2>
@@ -125,7 +125,7 @@
<a class="prev" href="index.html"><span class="dir">Previous</span>&larr; Overview</a>
<a class="next" href="how-it-works.html"><span class="dir">Next</span>How it works &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/how-it-works.html b/docs/guide/how-it-works.html
index 8a94371..8da7f5d 100644
--- a/docs/guide/how-it-works.html
+++ b/docs/guide/how-it-works.html
@@ -57,7 +57,7 @@
<h2>Two backends</h2>
<p>Podroid supports two hypervisor backends, selectable in Settings. The guest is identical either way - only the host-side virtualization layer differs.</p>
<ul>
- <li><strong>QEMU (default):</strong> software CPU emulation via TCG. Works on any ARM64 Android 9+ device. Slower than native because every guest instruction is translated and executed by the host CPU. See the <a href="backends.html">Backends</a> page for tuning options.</li>
+ <li><strong>QEMU (default):</strong> software CPU emulation via TCG. Works on any ARM64 Android 8+ device. Slower than native because every guest instruction is translated and executed by the host CPU. See the <a href="backends.html">Backends</a> page for tuning options.</li>
<li><strong>AVF / pKVM:</strong> hardware virtualization via Android's Virtualization Framework. Available on recent Pixel devices that ship pKVM. Runs at near-native speed. Requires two one-time <code>adb</code> permission grants. See <a href="backends.html">Backends: QEMU &amp; AVF</a>.</li>
</ul>
@@ -143,7 +143,7 @@
<a class="prev" href="getting-started.html"><span class="dir">Previous</span>&larr; Getting started</a>
<a class="next" href="performance.html"><span class="dir">Next</span>Performance &amp; why it's slow &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/index.html b/docs/guide/index.html
index 389e753..373f055 100644
--- a/docs/guide/index.html
+++ b/docs/guide/index.html
@@ -51,7 +51,7 @@
<h1>Podroid documentation</h1>
<p class="lead">Podroid runs real Linux - Podman, Docker, LXC, and a Linux desktop - on an Android phone, with no root and no custom recovery. It boots an Alpine Linux VM with a custom Linux 7.0.10 kernel inside the app.</p>
- <p>There are two ways the VM runs. By default it uses <strong>QEMU</strong> with software CPU emulation (TCG), which works on any ARM64 Android 9+ device. On recent Pixel devices that ship pKVM, Podroid can instead use the <strong>Android Virtualization Framework (AVF)</strong> for near-native speed. Either way you get the same Alpine guest, the same terminal, and the same in-app X11 viewer for GUI apps.</p>
+ <p>There are two ways the VM runs. By default it uses <strong>QEMU</strong> with software CPU emulation (TCG), which works on any ARM64 Android 8+ device. On recent Pixel devices that ship pKVM, Podroid can instead use the <strong>Android Virtualization Framework (AVF)</strong> for near-native speed. Either way you get the same Alpine guest, the same terminal, and the same in-app X11 viewer for GUI apps.</p>
<div class="callout note">
<span class="label">No root required</span>
@@ -81,7 +81,7 @@
<span></span>
<a class="next" href="getting-started.html"><span class="dir">Next</span>Getting started →</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/limitations.html b/docs/guide/limitations.html
index f225a39..c0a6682 100644
--- a/docs/guide/limitations.html
+++ b/docs/guide/limitations.html
@@ -74,8 +74,8 @@
</tr>
<tr>
<td>OS version</td>
- <td>Android 9+ required (minSdk 28)</td>
- <td>Features such as <code>memfd_create</code> and the required SELinux/seccomp policy are only stable from API 28. Android 8 is blocked additionally by glib/iconv linking issues in the QEMU build.</td>
+ <td>Android 8+ required (minSdk 26)</td>
+ <td>API 26 is the floor for the SELinux/seccomp policy and native ABI the VM relies on. Android 8 and 8.1 are supported as of v1.2.5; an iconv shim in the QEMU build resolved the earlier glib linking issue that previously blocked them.</td>
</tr>
<tr>
<td>AVF backend</td>
@@ -85,7 +85,12 @@
<tr>
<td>AVF CPU count</td>
<td>No fine-grained vCPU selection</td>
- <td>Requesting more than one vCPU under AVF gives the VM all available host cores rather than the exact count chosen in Settings. The CPU count setting has full effect on the QEMU backend only.</td>
+ <td>The AVF API exposes only one vCPU or all host cores, not an exact count, so the CPU count setting is precise on the QEMU backend only. As of v1.2.5, multi-core AVF works reliably: if a device cannot bring up every core at boot (seen on Tensor G3/G4 Pixels), Podroid automatically retries with fewer cores and remembers the highest count that boots.</td>
+ </tr>
+ <tr>
+ <td>AVF on the Android 17 beta</td>
+ <td>VMs fail to boot (boot loop, empty console)</td>
+ <td>On the Android 17 beta, the system VM manager and its bundled crosvm disagree on guest networking, so AVF VMs reset before the guest loads. This is a platform-side beta regression, not a Podroid bug. Switch the backend to QEMU (TCG) in Settings until Google resolves it; QEMU is unaffected.</td>
</tr>
<tr>
<td>USB passthrough</td>
@@ -188,7 +193,7 @@
<a class="prev" href="settings.html"><span class="dir">Previous</span>&larr; Terminal &amp; settings</a>
<a class="next" href="use-cases.html"><span class="dir">Next</span>Use cases &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/migrations.html b/docs/guide/migrations.html
index 9e553a8..229156c 100644
--- a/docs/guide/migrations.html
+++ b/docs/guide/migrations.html
@@ -142,7 +142,7 @@ rc-update -u add my-service default</code></pre>
<a class="prev" href="packages.html"><span class="dir">Previous</span>&larr; Packages &amp; services</a>
<a class="next" href="desktop.html"><span class="dir">Next</span>Desktops &amp; X11 viewer &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/networking.html b/docs/guide/networking.html
index 5113a7f..f4c121d 100644
--- a/docs/guide/networking.html
+++ b/docs/guide/networking.html
@@ -222,7 +222,7 @@ podroid-server status</code></pre>
<a class="prev" href="backends.html"><span class="dir">Previous</span>&larr; Backends: QEMU &amp; AVF</a>
<a class="next" href="packages.html"><span class="dir">Next</span>Packages &amp; services &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/packages.html b/docs/guide/packages.html
index 17b3602..fbeb182 100644
--- a/docs/guide/packages.html
+++ b/docs/guide/packages.html
@@ -199,7 +199,7 @@
<a class="prev" href="networking.html"><span class="dir">Previous</span>&larr; Networking &amp; ports</a>
<a class="next" href="desktop.html"><span class="dir">Next</span>Desktops &amp; X11 viewer &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/performance.html b/docs/guide/performance.html
index 6c43d46..501ad0c 100644
--- a/docs/guide/performance.html
+++ b/docs/guide/performance.html
@@ -147,7 +147,7 @@
<a class="prev" href="how-it-works.html"><span class="dir">Previous</span>&larr; How it works</a>
<a class="next" href="backends.html"><span class="dir">Next</span>Backends: QEMU &amp; AVF &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/settings.html b/docs/guide/settings.html
index a8bf6cd..ca79170 100644
--- a/docs/guide/settings.html
+++ b/docs/guide/settings.html
@@ -209,7 +209,7 @@
<a class="prev" href="desktop.html"><span class="dir">Previous</span>← Desktops &amp; X11 viewer</a>
<a class="next" href="limitations.html"><span class="dir">Next</span>Limitations &amp; troubleshooting →</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/use-cases.html b/docs/guide/use-cases.html
index 00ddd8b..90468e9 100644
--- a/docs/guide/use-cases.html
+++ b/docs/guide/use-cases.html
@@ -162,7 +162,7 @@
<a class="prev" href="limitations.html"><span class="dir">Previous</span>&larr; Limitations &amp; troubleshooting</a>
<span></span>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.3. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.5. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/index.html b/docs/index.html
index c909ef0..ea17002 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -6,7 +6,7 @@
<title>Podroid: Linux containers on Android, no root required</title>
<meta name="description" content="Podroid runs Podman, Docker, and LXC on Android in a real Alpine Linux VM with a custom Linux 7.0.10 kernel - via QEMU on any ARM64 device, or hardware-accelerated AVF (pKVM) on supported Pixels - plus an in-app X11 desktop for GUI apps. No root, no custom recovery." />
<meta property="og:title" content="Podroid: Linux containers on Android, no root required" />
- <meta property="og:description" content="Spin up a real Alpine Linux VM with a full Podman runtime on any Android 9+ ARM64 device. QEMU software emulation everywhere, or near-native AVF (pKVM) acceleration on supported Pixels. No root, no Magisk." />
+ <meta property="og:description" content="Spin up a real Alpine Linux VM with a full Podman runtime on any Android 8+ ARM64 device. QEMU software emulation everywhere, or near-native AVF (pKVM) acceleration on supported Pixels. No root, no Magisk." />
<meta property="og:type" content="website" />
<meta property="og:url" content="https://extv.github.io/Podroid/" />
<meta property="og:image" content="https://extv.github.io/Podroid/logo.png" />
@@ -584,7 +584,7 @@
View on GitHub
</a>
</div>
- <p class="hero-meta">ARM64 · Android 9+ · No root · GPLv2</p>
+ <p class="hero-meta">ARM64 · Android 8+ · No root · GPLv2</p>
</section>
<!-- FEATURES -->
@@ -772,7 +772,7 @@
</tr>
<tr>
<td class="row-label">Works on any ARM64</td>
- <td class="col-podroid"><span class="check">✓ Android 9+</span></td>
+ <td class="col-podroid"><span class="check">✓ Android 8+</span></td>
<td><span class="check">✓</span></td>
<td><span class="cross">✗ Pixel only</span></td>
</tr>
@@ -895,7 +895,7 @@ qmp.sock → runtime port-forward control</div>
</div>
<div class="qs-step">
<div class="qs-step-num">2</div>
- <p><strong>Install</strong> it on your Android device (ARM64, Android 9+).</p>
+ <p><strong>Install</strong> it on your Android device (ARM64, Android 8+).</p>
</div>
<div class="qs-step">
<div class="qs-step-num">3</div>
@@ -942,7 +942,7 @@ qmp.sock → runtime port-forward control</div>
<details>
<summary>Does this require root or a modified Android?</summary>
<div class="faq-answer">
- No. Podroid runs entirely in userspace using QEMU's TCG (software emulation). No root, no custom recovery, no Magisk. Any stock Android 9+ ARM64 device works.
+ No. Podroid runs entirely in userspace using QEMU's TCG (software emulation). No root, no custom recovery, no Magisk. Any stock Android 8+ ARM64 device works.
</div>
</details>
@@ -956,7 +956,7 @@ qmp.sock → runtime port-forward control</div>
<details>
<summary>How is this different from Google Terminal / AVF?</summary>
<div class="faq-answer">
- Google's Terminal app uses Android Virtualization Framework (AVF), a system-level hypervisor available only on recent Pixel devices. It gives you a Debian VM but no container runtime and limited configurability. Podroid runs on <em>any</em> ARM64 Android 9+ device via QEMU TCG (software emulation), and on a Pixel that ships pKVM it can use AVF too for near-native speed - the same Alpine guest either way. It ships with three container engines, port forwarding, SSH, an in-app X11 desktop, and a configurable terminal.
+ Google's Terminal app uses Android Virtualization Framework (AVF), a system-level hypervisor available only on recent Pixel devices. It gives you a Debian VM but no container runtime and limited configurability. Podroid runs on <em>any</em> ARM64 Android 8+ device via QEMU TCG (software emulation), and on a Pixel that ships pKVM it can use AVF too for near-native speed - the same Alpine guest either way. It ships with three container engines, port forwarding, SSH, an in-app X11 desktop, and a configurable terminal.
</div>
</details>