Skip to content

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

docs: improve layout and fix formatting issues

ExTv03f24d10827c
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..ee45924
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,918 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <title>Podroid — Linux containers on Android, no root required</title>
+ <meta name="description" content="Podroid runs rootless Podman containers on Android — full Alpine Linux VM via QEMU with a custom 6.6 kernel. No root, no custom recovery, any ARM64 device." />
+ <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. No root, no Magisk, no AVF requirement." />
+ <meta property="og:type" content="website" />
+ <meta property="og:url" content="https://extv.github.io/Podroid/" />
+ <meta property="og:image" content="https://github.com/ExTV.png" />
+ <meta name="twitter:card" content="summary" />
+ <meta name="twitter:title" content="Podroid" />
+ <meta name="twitter:description" content="Linux containers on Android, no root required." />
+ <meta name="twitter:image" content="https://github.com/ExTV.png" />
+ <link rel="icon" type="image/png" href="https://github.com/ExTV.png" />
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,300;0,9..40,400;0,9..40,500;0,9..40,600;1,9..40,400&family=DM+Mono:wght@400;500&display=swap" rel="stylesheet" />
+ <style>
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+ /* ── Tokyo Night palette ───────────────────────────── */
+ :root {
+ --bg: #1a1b26;
+ --bg-dark: #16161e;
+ --bg-card: #1f2335;
+ --bg-card2: #24283b;
+ --border: #292e42;
+ --text: #c0caf5;
+ --text-dim: #a9b1d6;
+ --muted: #7982b0;
+ --green: #9ece6a;
+ --green-dim: #1e3319;
+ --blue: #7aa2f7;
+ --cyan: #7dcfff;
+ --yellow: #e0af68;
+ --red: #f7768e;
+ --purple: #bb9af7;
+ }
+
+ html { scroll-behavior: smooth; }
+
+ body {
+ font-family: 'DM Sans', sans-serif;
+ background: var(--bg);
+ color: var(--text);
+ line-height: 1.6;
+ -webkit-font-smoothing: antialiased;
+ }
+
+ a { color: var(--blue); text-decoration: none; }
+ a:hover { color: var(--cyan); text-decoration: underline; }
+
+ code, pre, .mono { font-family: 'DM Mono', monospace; }
+
+ /* ── NAV ───────────────────────────────────────────── */
+ nav {
+ position: sticky;
+ top: 0;
+ z-index: 100;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 0 2rem;
+ height: 56px;
+ background: rgb(22 22 30 / 0.9);
+ backdrop-filter: blur(14px);
+ border-bottom: 1px solid var(--border);
+ }
+
+ .nav-logo {
+ display: flex;
+ align-items: center;
+ gap: 0.6rem;
+ font-weight: 600;
+ font-size: 1rem;
+ color: var(--text);
+ text-decoration: none !important;
+ }
+
+ .nav-logo img {
+ width: 26px;
+ height: 26px;
+ border-radius: 6px;
+ }
+
+ .nav-links {
+ display: flex;
+ align-items: center;
+ gap: 1.6rem;
+ list-style: none;
+ }
+
+ .nav-links a {
+ color: var(--muted);
+ font-size: 0.875rem;
+ font-weight: 500;
+ white-space: nowrap;
+ transition: color 0.15s;
+ }
+
+ .nav-links a:hover { color: var(--text-dim); text-decoration: none; }
+
+ .btn {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.4rem;
+ padding: 0.5rem 1.1rem;
+ border-radius: 6px;
+ font-size: 0.875rem;
+ font-weight: 600;
+ cursor: pointer;
+ transition: opacity 0.15s, transform 0.1s;
+ text-decoration: none !important;
+ font-family: 'DM Sans', sans-serif;
+ }
+
+ .btn:hover { opacity: 0.85; transform: translateY(-1px); text-decoration: none; }
+ .btn-primary { background: var(--green); color: var(--bg-dark); }
+ .btn-ghost { border: 1px solid var(--border); color: var(--text-dim); background: transparent; }
+ .btn-ghost:hover { border-color: var(--muted); color: var(--text); }
+
+ /* ── HERO ──────────────────────────────────────────── */
+ #hero {
+ padding: 7rem 2rem 5.5rem;
+ text-align: center;
+ max-width: 760px;
+ margin: 0 auto;
+ }
+
+ h1 {
+ font-size: clamp(2.4rem, 5vw, 3.6rem);
+ font-weight: 600;
+ line-height: 1.2;
+ letter-spacing: -0.03em;
+ text-wrap: balance;
+ margin-bottom: 1.8rem;
+ color: var(--text);
+ }
+
+ h1 em {
+ font-style: normal;
+ color: var(--green);
+ }
+
+ .hero-sub {
+ font-size: 1.05rem;
+ color: var(--text-dim);
+ max-width: 100%;
+ margin: 0 auto 2.5rem;
+ text-wrap: pretty;
+ line-height: 1.7;
+ }
+
+ .hero-actions {
+ display: flex;
+ gap: 0.75rem;
+ justify-content: center;
+ flex-wrap: wrap;
+ margin-bottom: 1.5rem;
+ }
+
+ .hero-meta {
+ font-size: 0.78rem;
+ color: var(--muted);
+ font-family: 'DM Mono', monospace;
+ letter-spacing: 0.03em;
+ }
+
+ /* ── SECTIONS ──────────────────────────────────────── */
+ section { padding: 5rem 2rem; }
+
+ .container { max-width: 1000px; margin: 0 auto; }
+
+ .section-label {
+ font-size: 0.72rem;
+ font-family: 'DM Mono', monospace;
+ color: var(--purple);
+ letter-spacing: 0.12em;
+ text-transform: uppercase;
+ margin-bottom: 0.6rem;
+ }
+
+ h2 {
+ font-size: clamp(1.6rem, 3vw, 2.2rem);
+ font-weight: 600;
+ letter-spacing: -0.02em;
+ margin-bottom: 0.55rem;
+ color: var(--text);
+ }
+
+ .section-sub {
+ color: var(--text-dim);
+ max-width: 560px;
+ font-size: 0.975rem;
+ text-wrap: pretty;
+ margin-bottom: 2.8rem;
+ line-height: 1.65;
+ }
+
+ /* ── FEATURES ──────────────────────────────────────── */
+ #features { background: var(--bg-card); }
+
+ .features-grid {
+ display: grid;
+ grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+ gap: 1px;
+ background: var(--border);
+ border: 1px solid var(--border);
+ border-radius: 10px;
+ overflow: hidden;
+ }
+
+ .feature-card {
+ background: var(--bg-card);
+ padding: 1.8rem;
+ display: flex;
+ flex-direction: column;
+ gap: 0.55rem;
+ transition: background 0.15s;
+ }
+
+ .feature-card:hover { background: var(--bg-card2); }
+
+ .feature-icon {
+ width: 36px;
+ height: 36px;
+ background: var(--green-dim);
+ border: 1px solid rgba(158, 206, 106, 0.15);
+ border-radius: 8px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ margin-bottom: 0.3rem;
+ color: var(--green);
+ }
+
+ .feature-card h3 {
+ font-size: 0.925rem;
+ font-weight: 600;
+ color: var(--text);
+ }
+
+ .feature-card p {
+ font-size: 0.858rem;
+ color: var(--text-dim);
+ line-height: 1.65;
+ }
+
+ /* ── COMPARISON ────────────────────────────────────── */
+ #comparison { background: var(--bg); }
+
+ .table-wrap {
+ overflow-x: auto;
+ border: 1px solid var(--border);
+ border-radius: 10px;
+ }
+
+ table {
+ width: 100%;
+ border-collapse: collapse;
+ font-size: 0.875rem;
+ }
+
+ thead { background: var(--bg-dark); }
+
+ th {
+ padding: 1rem 1.2rem;
+ text-align: left;
+ font-weight: 600;
+ font-size: 0.82rem;
+ color: var(--text-dim);
+ border-bottom: 1px solid var(--border);
+ }
+
+ th:not(:first-child) { text-align: center; }
+ th.col-podroid { color: var(--green); }
+
+ td {
+ padding: 0.85rem 1.2rem;
+ border-bottom: 1px solid var(--border);
+ color: var(--text-dim);
+ vertical-align: middle;
+ }
+
+ tbody tr:hover td { background: rgb(36 40 59 / 0.5); }
+ tr:last-child td { border-bottom: none; }
+ td:not(:first-child) { text-align: center; }
+
+ td.row-label { color: var(--text); font-weight: 500; }
+ td.col-podroid { background: rgb(28 39 20 / 0.6); }
+
+ .check { color: var(--green); font-size: 0.9rem; font-weight: 600; }
+ .cross { color: var(--muted); font-size: 0.9rem; }
+ .partial { color: var(--yellow); font-size: 0.78rem; font-family: 'DM Mono', monospace; }
+
+ .col-header-wrap {
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ gap: 0.2rem;
+ }
+
+ .col-badge {
+ font-size: 0.65rem;
+ font-weight: 400;
+ color: var(--muted);
+ font-family: 'DM Mono', monospace;
+ }
+
+ /* ── HOW IT WORKS ──────────────────────────────────── */
+ #how { background: var(--bg-card); }
+
+ .arch-diagram {
+ background: var(--bg-dark);
+ border: 1px solid var(--border);
+ border-radius: 10px;
+ padding: 1.8rem 2rem;
+ font-family: 'DM Mono', monospace;
+ font-size: 0.78rem;
+ line-height: 1.9;
+ color: var(--muted);
+ overflow-x: auto;
+ white-space: pre;
+ }
+
+ .arch-green { color: var(--green); }
+ .arch-blue { color: var(--blue); }
+ .arch-white { color: var(--text-dim); }
+
+ .steps {
+ display: grid;
+ grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
+ gap: 1rem;
+ margin-top: 2.5rem;
+ }
+
+ .step {
+ background: var(--bg-dark);
+ border: 1px solid var(--border);
+ border-radius: 8px;
+ padding: 1.2rem;
+ display: flex;
+ gap: 0.8rem;
+ }
+
+ .step-num {
+ flex-shrink: 0;
+ width: 24px;
+ height: 24px;
+ border-radius: 50%;
+ background: var(--green-dim);
+ border: 1px solid rgba(158, 206, 106, 0.2);
+ color: var(--green);
+ font-size: 0.7rem;
+ font-family: 'DM Mono', monospace;
+ font-weight: 500;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ flex-shrink: 0;
+ }
+
+ .step-body h4 {
+ font-size: 0.875rem;
+ font-weight: 600;
+ margin-bottom: 0.25rem;
+ color: var(--text);
+ }
+
+ .step-body p {
+ font-size: 0.8rem;
+ color: var(--text-dim);
+ line-height: 1.55;
+ }
+
+ .step-body code {
+ font-family: 'DM Mono', monospace;
+ font-size: 0.78em;
+ background: var(--bg-card2);
+ color: var(--cyan);
+ padding: 0.1em 0.35em;
+ border-radius: 4px;
+ }
+
+ /* ── QUICK START ───────────────────────────────────── */
+ #quickstart { background: var(--bg); }
+
+ .qs-grid {
+ display: grid;
+ grid-template-columns: 1fr 1fr;
+ gap: 2.5rem;
+ align-items: start;
+ }
+
+ @media (max-width: 640px) {
+ .qs-grid { grid-template-columns: 1fr; }
+ }
+
+ .qs-steps {
+ display: flex;
+ flex-direction: column;
+ gap: 1rem;
+ }
+
+ .qs-step {
+ display: flex;
+ gap: 0.85rem;
+ align-items: flex-start;
+ }
+
+ .qs-step-num {
+ flex-shrink: 0;
+ width: 22px;
+ height: 22px;
+ border-radius: 50%;
+ background: var(--green);
+ color: var(--bg-dark);
+ font-size: 0.7rem;
+ font-family: 'DM Mono', monospace;
+ font-weight: 700;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ margin-top: 3px;
+ }
+
+ .qs-step p { font-size: 0.9rem; color: var(--text-dim); line-height: 1.55; }
+ .qs-step strong { color: var(--text); font-weight: 600; }
+ .qs-step a { color: var(--blue); }
+
+ .code-block {
+ background: var(--bg-dark);
+ border: 1px solid var(--border);
+ border-radius: 10px;
+ padding: 1.3rem 1.5rem;
+ font-family: 'DM Mono', monospace;
+ font-size: 0.8rem;
+ line-height: 2;
+ color: var(--muted);
+ overflow-x: auto;
+ white-space: pre;
+ }
+
+ .c-prompt { color: var(--green); user-select: none; }
+ .c-comment { color: var(--muted); }
+ .c-cmd { color: var(--text-dim); }
+
+ /* ── FAQ ───────────────────────────────────────────── */
+ #faq { background: var(--bg-card); }
+
+ .faq-list {
+ border: 1px solid var(--border);
+ border-radius: 10px;
+ overflow: hidden;
+ }
+
+ details {
+ border-bottom: 1px solid var(--border);
+ background: var(--bg-card);
+ transition: background 0.15s;
+ }
+
+ details[open] { background: var(--bg-card2); }
+ details:last-child { border-bottom: none; }
+
+ summary {
+ padding: 1.1rem 1.5rem;
+ font-size: 0.9rem;
+ font-weight: 500;
+ color: var(--text);
+ cursor: pointer;
+ list-style: none;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 1rem;
+ transition: color 0.15s;
+ }
+
+ summary::-webkit-details-marker { display: none; }
+ summary:hover { color: var(--blue); }
+
+ summary::after {
+ content: '+';
+ font-size: 1.3rem;
+ font-weight: 300;
+ color: var(--muted);
+ flex-shrink: 0;
+ }
+
+ details[open] summary::after { content: '−'; color: var(--blue); }
+
+ .faq-answer {
+ padding: 0 1.5rem 1.2rem;
+ font-size: 0.875rem;
+ color: var(--text-dim);
+ line-height: 1.75;
+ }
+
+ .faq-answer code {
+ background: var(--bg-dark);
+ border: 1px solid var(--border);
+ padding: 0.1em 0.4em;
+ border-radius: 4px;
+ font-size: 0.82em;
+ color: var(--cyan);
+ }
+
+ /* ── FOOTER ────────────────────────────────────────── */
+ footer {
+ border-top: 1px solid var(--border);
+ padding: 2rem;
+ text-align: center;
+ font-size: 0.78rem;
+ color: var(--muted);
+ font-family: 'DM Mono', monospace;
+ }
+
+ footer a { color: var(--muted); }
+ footer a:hover { color: var(--text-dim); text-decoration: none; }
+
+ /* ── RESPONSIVE ────────────────────────────────────── */
+ @media (max-width: 600px) {
+ nav .nav-links { display: none; }
+ .arch-diagram { font-size: 0.62rem; }
+ }
+ </style>
+</head>
+<body>
+
+<!-- NAV -->
+<nav>
+ <a href="https://github.com/ExTV/Podroid" class="nav-logo">
+ <img src="https://github.com/ExTV.png" alt="Podroid" />
+ Podroid
+ </a>
+ <ul class="nav-links">
+ <li><a href="#features">Features</a></li>
+ <li><a href="#comparison">Compare</a></li>
+ <li><a href="#how">How it works</a></li>
+ <li><a href="#quickstart">Quick start</a></li>
+ <li><a href="#faq">FAQ</a></li>
+ </ul>
+</nav>
+
+<!-- HERO -->
+<section id="hero">
+ <h1>Linux containers on Android.<br /><em>No root required.</em></h1>
+ <p class="hero-sub">
+ Podroid spins up a real Alpine Linux VM using QEMU and a custom&nbsp;kernel.<br />
+ You get a full Podman container runtime and a polished terminal.<br />
+ Install the APK, tap Start, run containers.
+ </p>
+ <div class="hero-actions">
+ <a href="https://github.com/ExTV/Podroid/releases" class="btn btn-primary">
+ <svg width="14" height="14" fill="none" stroke="currentColor" stroke-width="2.2" viewBox="0 0 24 24"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+ Download APK
+ </a>
+ <a href="https://github.com/ExTV/Podroid" class="btn btn-ghost">
+ <svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0 0 24 12c0-6.63-5.37-12-12-12z"/></svg>
+ View on GitHub
+ </a>
+ </div>
+ <p class="hero-meta">ARM64 · Android 9+ · No root · GPLv2</p>
+</section>
+
+<!-- FEATURES -->
+<section id="features">
+ <div class="container">
+ <p class="section-label">Features</p>
+ <h2>Everything a dev environment should have</h2>
+ <p class="section-sub">Built from the kernel up for containers, not just shell access.</p>
+
+ <div class="features-grid">
+
+ <div class="feature-card">
+ <div class="feature-icon">
+ <svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" viewBox="0 0 24 24"><rect x="2" y="7" width="20" height="14" rx="2"/><path d="M16 7V5a2 2 0 0 0-2-2h-4a2 2 0 0 0-2 2v2"/><line x1="12" y1="12" x2="12" y2="16"/><line x1="10" y1="14" x2="14" y2="14"/></svg>
+ </div>
+ <h3>Rootless Podman</h3>
+ <p>Full Docker-compatible container runtime. Pull from Docker Hub, run images, manage networks — all without root or custom kernel modules on the host.</p>
+ </div>
+
+ <div class="feature-card">
+ <div class="feature-icon">
+ <svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" viewBox="0 0 24 24"><circle cx="12" cy="12" r="3"/><path d="M12 1v4M12 19v4M4.22 4.22l2.83 2.83M16.95 16.95l2.83 2.83M1 12h4M19 12h4M4.22 19.78l2.83-2.83M16.95 7.05l2.83-2.83"/></svg>
+ </div>
+ <h3>Custom Linux 6.6 Kernel</h3>
+ <p>Compiled from scratch with netfilter, bridge, overlayfs, veth, and cgroup v2 built-in. Every feature Podman needs is already there — no module loading.</p>
+ </div>
+
+ <div class="feature-card">
+ <div class="feature-icon">
+ <svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" viewBox="0 0 24 24"><rect x="2" y="3" width="20" height="14" rx="2"/><polyline points="8 21 12 17 16 21"/></svg>
+ </div>
+ <h3>Real Terminal</h3>
+ <p>Termux TerminalView with xterm-256color, proper PTY, full mouse support, 114 color themes, 13 fonts, and an extra-keys bar with F1–F12, ESC, CTRL, ALT.</p>
+ </div>
+
+ <div class="feature-card">
+ <div class="feature-icon">
+ <svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" viewBox="0 0 24 24"><polyline points="17 1 21 5 17 9"/><path d="M3 11V9a4 4 0 0 1 4-4h14"/><polyline points="7 23 3 19 7 15"/><path d="M21 13v2a4 4 0 0 1-4 4H3"/></svg>
+ </div>
+ <h3>Port Forwarding</h3>
+ <p>Expose any VM port to your Android device at runtime via QMP control. Run a web server, database, or API and hit it from your phone's browser.</p>
+ </div>
+
+ <div class="feature-card">
+ <div class="feature-icon">
+ <svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" viewBox="0 0 24 24"><path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07A19.5 19.5 0 0 1 4.69 12 19.79 19.79 0 0 1 1.63 3.42 2 2 0 0 1 3.6 1.24h3a2 2 0 0 1 2 1.72c.127.96.361 1.903.7 2.81a2 2 0 0 1-.45 2.11L7.91 8.84a16 16 0 0 0 6.29 6.29l.96-.96a2 2 0 0 1 2.11-.45c.907.339 1.85.573 2.81.7A2 2 0 0 1 22 16.92z"/></svg>
+ </div>
+ <h3>Built-in SSH</h3>
+ <p>Dropbear SSH server on port 9922 (configurable). Connect from your laptop, VS Code Remote, or any SSH client on the same network.</p>
+ </div>
+
+ <div class="feature-card">
+ <div class="feature-icon">
+ <svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" viewBox="0 0 24 24"><path d="M13 2L3 14h9l-1 8 10-12h-9l1-8z"/></svg>
+ </div>
+ <h3>Persistent &amp; Fast</h3>
+ <p>Overlayfs over a persistent ext4 image. Containers, packages, and configs survive reboots. ZRAM swap gives 2× effective RAM. Boots in 6–15 seconds.</p>
+ </div>
+
+ </div>
+ </div>
+</section>
+
+<!-- COMPARISON -->
+<section id="comparison">
+ <div class="container">
+ <p class="section-label">Comparison</p>
+ <h2>How Podroid stacks up</h2>
+ <p class="section-sub">Termux gives you a Linux shell. Google Terminal gives you a VM with optional manual container setup. Podroid ships a full container runtime out of the box.</p>
+
+ <div class="table-wrap">
+ <table>
+ <thead>
+ <tr>
+ <th style="width:34%">Capability</th>
+ <th class="col-podroid">
+ <div class="col-header-wrap">
+ Podroid
+ <span class="col-badge">this project</span>
+ </div>
+ </th>
+ <th>
+ <div class="col-header-wrap">
+ Termux
+ <span class="col-badge">v0.118+</span>
+ </div>
+ </th>
+ <th>
+ <div class="col-header-wrap">
+ Google Terminal
+ <span class="col-badge">AVF</span>
+ </div>
+ </th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td class="row-label">Root required</td>
+ <td class="col-podroid"><span class="check">✓ No</span></td>
+ <td><span class="check">✓ No</span></td>
+ <td><span class="check">✓ No</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">Real container runtime</td>
+ <td class="col-podroid"><span class="check">✓ Podman</span></td>
+ <td><span class="cross">✗</span></td>
+ <td><span class="partial">manual setup</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">VM isolation</td>
+ <td class="col-podroid"><span class="check">✓ QEMU</span></td>
+ <td><span class="cross">✗ shared kernel</span></td>
+ <td><span class="check">✓ AVF</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">Docker Hub images</td>
+ <td class="col-podroid"><span class="check">✓</span></td>
+ <td><span class="cross">✗</span></td>
+ <td><span class="partial">manual setup</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">Custom kernel</td>
+ <td class="col-podroid"><span class="check">✓ Linux 6.6.87</span></td>
+ <td><span class="cross">✗ host kernel</span></td>
+ <td><span class="check">✓</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">Works on any ARM64</td>
+ <td class="col-podroid"><span class="check">✓ Android 9+</span></td>
+ <td><span class="check">✓</span></td>
+ <td><span class="cross">✗ Pixel only</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">Port forwarding</td>
+ <td class="col-podroid"><span class="check">✓ via QMP</span></td>
+ <td><span class="partial">via socat</span></td>
+ <td><span class="cross">✗</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">Downloads folder sharing</td>
+ <td class="col-podroid"><span class="check">✓ virtio-9p</span></td>
+ <td><span class="check">✓</span></td>
+ <td><span class="cross">✗</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">SSH server</td>
+ <td class="col-podroid"><span class="check">✓ Dropbear</span></td>
+ <td><span class="partial">via pkg</span></td>
+ <td><span class="partial">manual setup</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">xterm-256color + mouse</td>
+ <td class="col-podroid"><span class="check">✓</span></td>
+ <td><span class="check">✓</span></td>
+ <td><span class="partial">basic</span></td>
+ </tr>
+ <tr>
+ <td class="row-label">Configurable RAM / CPUs</td>
+ <td class="col-podroid"><span class="check">✓ 512MB–4GB, 1–8 cores</span></td>
+ <td><span class="cross">✗</span></td>
+ <td><span class="partial">limited</span></td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ </div>
+</section>
+
+<!-- HOW IT WORKS -->
+<section id="how">
+ <div class="container">
+ <p class="section-label">Architecture</p>
+ <h2>How it works</h2>
+ <p class="section-sub">Three channels, one VM, zero root. Here's what happens when you tap Start.</p>
+
+ <div class="arch-diagram"><span class="arch-white">┌────────────────────── Android App (Compose) ─────────────────────────┐
+│ │
+│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
+│ │ PodroidService │ │ QEMU 11 TCG │ │ Terminal UI │ │
+│ │ (ForegroundSvc) │ │ ARM64-native │ │ Termux View │ │
+│ └────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘ │
+└───────────┼─────────────────────┼─────────────────────┼──────────────┘
+ │ │ │
+ │ ┌─────────────────▼────────────────┐ │
+ │ │ Alpine Linux 3.23 VM │ │
+ │ │ ┌──────────┐ ┌──────────────┐ │ │
+ │ │ │ Podman │ │ Linux 6.6 │ │ │
+ └──►│ │(rootless)│ │ (custom) │ │◄───┘
+ boot stages │ └──────────┘ └──────────────┘ │ libpodroid-bridge.so
+ │ │ PTY ↔ virtio-console
+ └──────────────────────────────────┘</span>
+
+<span class="arch-green">terminal.sock</span> ↔ hvc0 → primary shell I/O
+<span class="arch-blue">ctrl.sock </span> ↔ hvc1 → debounced SIGWINCH resize signals
+<span class="arch-white">serial.sock </span> ↔ ttyAMA0 → boot log stream → boot stage detection
+qmp.sock → runtime port-forward control</div>
+
+ <div class="steps">
+ <div class="step">
+ <div class="step-num">1</div>
+ <div class="step-body">
+ <h4>QEMU loads the kernel</h4>
+ <p>Custom Linux 6.6.87 + initramfs extracted from APK assets on first launch.</p>
+ </div>
+ </div>
+ <div class="step">
+ <div class="step-num">2</div>
+ <div class="step-body">
+ <h4>Phase 1: storage mount</h4>
+ <p>Init mounts <code>storage.img</code> as overlayfs for persistent container data.</p>
+ </div>
+ </div>
+ <div class="step">
+ <div class="step-num">3</div>
+ <div class="step-body">
+ <h4>Phase 2: services start</h4>
+ <p>Networking (SLIRP + MASQUERADE), cgroup v2, Podman runtime, and Dropbear SSH come up.</p>
+ </div>
+ </div>
+ <div class="step">
+ <div class="step-num">4</div>
+ <div class="step-body">
+ <h4>Bridge connects</h4>
+ <p><code>libpodroid-bridge.so</code> relays your PTY to the VM's virtio-console. Shell is ready.</p>
+ </div>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- QUICK START -->
+<section id="quickstart">
+ <div class="container">
+ <p class="section-label">Quick start</p>
+ <h2>Running in under a minute</h2>
+ <p class="section-sub">No configuration needed. Download, install, go.</p>
+
+ <div class="qs-grid">
+ <div class="qs-steps">
+ <div class="qs-step">
+ <div class="qs-step-num">1</div>
+ <p><strong>Download</strong> the latest APK from the <a href="https://github.com/ExTV/Podroid/releases">Releases page</a>.</p>
+ </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>
+ </div>
+ <div class="qs-step">
+ <div class="qs-step-num">3</div>
+ <p><strong>Tap Start VM.</strong> Watch the boot progress — typically ready in 6–15 seconds.</p>
+ </div>
+ <div class="qs-step">
+ <div class="qs-step-num">4</div>
+ <p><strong>Tap Open Terminal</strong> to access the Alpine shell.</p>
+ </div>
+ <div class="qs-step">
+ <div class="qs-step-num">5</div>
+ <p><strong>Run containers.</strong> Any image from Docker Hub works out of the box.</p>
+ </div>
+ </div>
+
+ <div class="code-block"><span class="c-comment"># hello world</span>
+<span class="c-prompt"># </span><span class="c-cmd">podman run --rm alpine echo hello</span>
+
+<span class="c-comment"># interactive shell</span>
+<span class="c-prompt"># </span><span class="c-cmd">podman run --rm -it ubuntu bash</span>
+
+<span class="c-comment"># nginx on port 8080</span>
+<span class="c-prompt"># </span><span class="c-cmd">podman run -d -p 8080:80 nginx</span>
+
+<span class="c-comment"># list running containers</span>
+<span class="c-prompt"># </span><span class="c-cmd">podman ps -a</span>
+
+<span class="c-comment"># SSH in from your laptop</span>
+<span class="c-prompt">$ </span><span class="c-cmd">ssh root@&lt;phone-ip&gt; -p 9922</span></div>
+ </div>
+ </div>
+</section>
+
+<!-- FAQ -->
+<section id="faq">
+ <div class="container">
+ <p class="section-label">FAQ</p>
+ <h2>Common questions</h2>
+ <p class="section-sub">If something isn't covered here, open an issue on GitHub.</p>
+
+ <div class="faq-list">
+
+ <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.
+ </div>
+ </details>
+
+ <details>
+ <summary>Why not just use Termux + proot?</summary>
+ <div class="faq-answer">
+ Termux is great for a Linux shell, but it runs on Android's host kernel. That kernel doesn't have the namespaces, cgroups, or netfilter rules needed for real containers. <code>proot</code> is a chroot emulation — containers built for Docker/Podman won't work reliably. Podroid runs a real VM with its own kernel purpose-built for Podman, so every OCI image from Docker Hub just works.
+ </div>
+ </details>
+
+ <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 on recent Pixel devices. It gives you a Debian VM but no container runtime and limited configurability. Podroid uses QEMU TCG (software emulation), which means it works on <em>any</em> ARM64 Android 9+ device — not just Pixels — and ships with a full Podman runtime, port forwarding, SSH, and a configurable terminal.
+ </div>
+ </details>
+
+ <details>
+ <summary>Is performance usable? QEMU is slow.</summary>
+ <div class="faq-answer">
+ TCG is software emulation, so compute-heavy workloads are slower than native. However, Podroid ships several optimizations: a 256–512 MB translation cache, a dedicated I/O thread for virtio-blk (big win for image pulls), ZRAM swap for 2× effective RAM, and <code>mitigations=off</code> in the guest kernel for a 5–15% CPU gain. For typical dev tasks — running a web server, a database, CLI tools — it's very usable.
+ </div>
+ </details>
+
+ <details>
+ <summary>Can I access my Android files from the VM?</summary>
+ <div class="faq-answer">
+ Yes. The Android Downloads folder is mounted into the VM via <code>virtio-9p</code>. Files you drop in Downloads are accessible inside the guest immediately.
+ </div>
+ </details>
+
+ <details>
+ <summary>How much storage does it use?</summary>
+ <div class="faq-answer">
+ The APK is ~200 MB (QEMU + kernel + initramfs + fonts). On first launch you choose a VM disk size between 2 GB and 64 GB — this is a sparse <code>storage.img</code> that only grows as you pull images and install packages.
+ </div>
+ </details>
+
+ <details>
+ <summary>Can I connect from my laptop over SSH?</summary>
+ <div class="faq-answer">
+ Yes. Dropbear SSH runs on port 9922 by default (configurable in Settings). As long as your laptop and phone are on the same network, <code>ssh root@&lt;phone-ip&gt; -p 9922</code> gives you a remote shell — useful for VS Code Remote or any SSH client.
+ </div>
+ </details>
+
+ </div>
+ </div>
+</section>
+
+<!-- FOOTER -->
+<footer>
+ <p>
+ Podroid · <a href="https://github.com/ExTV/Podroid">github.com/ExTV/Podroid</a> · GPLv2 ·
+ Built on <a href="https://www.qemu.org">QEMU</a>, <a href="https://podman.io">Podman</a>, <a href="https://alpinelinux.org">Alpine</a>, <a href="https://github.com/termux/termux-app">Termux</a>
+ </p>
+</footer>
+
+</body>
+</html>