A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.
chore(build): move to Linux 7.1.5 and Alpine 3.24.1
ExTvc18912d88418
diff --git a/CLAUDE.md b/CLAUDE.mdindex 39d5086..7296155 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -4,7 +4,7 @@ Guidance for Claude Code (and any AI assistant or new contributor) working in th## What Is This-Podroid is an Android app that runs a real **Alpine 3.23** Linux VM on stock Android 8+ (arm64) to provide rootless **Podman / Docker / LXC** containers and an in-app **X11 desktop** - no root, no custom recovery.+Podroid is an Android app that runs a real **Alpine 3.24** Linux VM on stock Android 8+ (arm64) to provide rootless **Podman / Docker / LXC** containers and an in-app **X11 desktop** - no root, no custom recovery.- **Two interchangeable VM backends** behind one interface (`VmEngine`):- **QEMU (TCG)** - software emulation, the default, needs no special permission.@@ -20,7 +20,7 @@ Podroid is an Android app that runs a real **Alpine 3.23** Linux VM on stock And| Version | `versionName` / `versionCode` in `app/build.gradle.kts` || Min / target SDK | 26 (Android 8) / 36 || Architecture | arm64 (`aarch64`) only |-| Guest | Alpine 3.23 squashfs + persistent ext4 overlay, OpenRC PID 1 |+| Guest | Alpine 3.24 squashfs + persistent ext4 overlay, OpenRC PID 1 || Kernel | custom Linux, version pinned by `podroidKernelVersion` in `gradle.properties` || QEMU | version pinned by `podroidQemuVersion` in `gradle.properties` || UI | Jetpack Compose + Material 3, single Activity |diff --git a/CREDITS.md b/CREDITS.mdindex d3f2570..48f52af 100644--- a/CREDITS.md+++ b/CREDITS.md@@ -11,14 +11,14 @@ If something you maintain is included here and we missed you, please open an issThese projects make up the actual Linux system that runs inside Podroid.### Linux kernel-Podroid ships a custom build of the upstream Linux kernel (currently 7.0.10) configured specifically for OCI-compatible containers under QEMU TCG.+Podroid ships a custom build of the upstream Linux kernel (currently 7.1.5) configured specifically for OCI-compatible containers under QEMU TCG.- Project: https://kernel.org- License: GNU General Public License v2.0- Maintainers: Linus Torvalds and the Linux kernel community### Alpine Linux-The guest userspace is a slightly customized Alpine Linux 3.23 root filesystem.+The guest userspace is a slightly customized Alpine Linux 3.24 root filesystem.- Project: https://alpinelinux.org- License: per-package (see Alpine's individual package licenses)diff --git a/Dockerfile b/Dockerfileindex 27e74ce..197dfd6 100644--- a/Dockerfile+++ b/Dockerfile@@ -7,7 +7,7 @@# SECTION 0: Custom Kernel Build (aarch64) — Image + modules# ==============================================================================FROM debian:bookworm AS kernel-builder-ARG KERNEL_VERSION=7.0.10+ARG KERNEL_VERSION=7.1.5ENV DEBIAN_FRONTEND=noninteractiveRUN apt-get update && apt-get install -y --no-install-recommends \wget ca-certificates xz-utils make gcc gcc-aarch64-linux-gnu binutils-aarch64-linux-gnu \@@ -169,16 +169,16 @@ RUN mkdir -p /output \# ==============================================================================# Stage 1: Download Alpine aarch64 artifacts-FROM alpine:3.23 AS downloader+FROM alpine:3.24 AS downloaderRUN apk add --no-cache wget cpio gzip tar xorrisoWORKDIR /downloads-RUN wget -q https://dl-cdn.alpinelinux.org/alpine/v3.23/releases/aarch64/alpine-netboot-3.23.3-aarch64.tar.gz \- && mkdir -p /netboot && tar -xf alpine-netboot-3.23.3-aarch64.tar.gz -C /netboot-RUN wget -q https://dl-cdn.alpinelinux.org/alpine/v3.23/releases/aarch64/alpine-virt-3.23.3-aarch64.iso \- && mkdir -p /iso && xorriso -osirrox on -indev alpine-virt-3.23.3-aarch64.iso -extract / /iso 2>/dev/null || true+RUN wget -q https://dl-cdn.alpinelinux.org/alpine/v3.24/releases/aarch64/alpine-netboot-3.24.1-aarch64.tar.gz \+ && mkdir -p /netboot && tar -xf alpine-netboot-3.24.1-aarch64.tar.gz -C /netboot+RUN wget -q https://dl-cdn.alpinelinux.org/alpine/v3.24/releases/aarch64/alpine-virt-3.24.1-aarch64.iso \+ && mkdir -p /iso && xorriso -osirrox on -indev alpine-virt-3.24.1-aarch64.iso -extract / /iso 2>/dev/null || true# Stage 2: Build the custom rootfs (aarch64) — no linux-virt; modules come from kernel-builder-FROM --platform=linux/arm64/v8 alpine:3.23 AS rootfs-builder+FROM --platform=linux/arm64/v8 alpine:3.24 AS rootfs-builderRUN apk update && apk add --no-cache \bash busybox busybox-extras ttyd podman \netavark aardvark-dns fuse-overlayfs slirp4netns iptables ip6tables \@@ -189,7 +189,7 @@ RUN chmod +x /initRUN rm -rf /var/cache/apk/* /tmp/* /var/tmp/* /usr/share/man /usr/share/doc# Stage 3: Pack Initramfs-FROM alpine:3.23 AS packer+FROM alpine:3.24 AS packerRUN apk add --no-cache cpio gzip findutilsCOPY --from=kernel-builder /output/vmlinuz-virt /output/vmlinuz-virtCOPY --from=rootfs-builder / /rootfs/diff --git a/app/src/main/java/com/excp/podroid/ui/screens/settings/SettingsScreen.kt b/app/src/main/java/com/excp/podroid/ui/screens/settings/SettingsScreen.ktindex 8eaec9d..068235a 100644--- a/app/src/main/java/com/excp/podroid/ui/screens/settings/SettingsScreen.kt+++ b/app/src/main/java/com/excp/podroid/ui/screens/settings/SettingsScreen.kt@@ -362,7 +362,7 @@ fun SettingsScreen(PodroidListRow(label = stringResource(R.string.version_label), value = "v${BuildConfig.VERSION_NAME}", mono = true)PodroidListRow(label = stringResource(R.string.qemu_label), value = "v${BuildConfig.QEMU_VERSION}", mono = true)PodroidListRow(label = stringResource(R.string.architecture), value = "AArch64", mono = true)- PodroidListRow(label = stringResource(R.string.linux_distro), value = "Alpine 3.23", mono = true)+ PodroidListRow(label = stringResource(R.string.linux_distro), value = "Alpine 3.24", mono = true)Spacer(Modifier.height(PodroidTokens.Spacing.MD))val uriHandler = LocalUriHandler.currentPodroidGhostButton(diff --git a/build-rootfs/Dockerfile.rootfs b/build-rootfs/Dockerfile.rootfsindex 56b98ed..73c79d4 100644--- a/build-rootfs/Dockerfile.rootfs+++ b/build-rootfs/Dockerfile.rootfs@@ -2,7 +2,7 @@# ── Stage 1: cross-compile podroid-vsock-agent (musl-static aarch64) ────────# Uses qemu-user under the hood — no separate cross-toolchain needed.-FROM --platform=linux/arm64 alpine:3.23 AS vsock-builder+FROM --platform=linux/arm64 alpine:3.24 AS vsock-builderRUN apk add --no-cache musl-dev gcc make linux-headersWORKDIR /workCOPY vsock-agent /work/vsock-agent@@ -13,9 +13,9 @@ COPY overlay-normalize /work/overlay-normalizeRUN cd /work/overlay-normalize && make CC=gcc# ── Stage 2: build the Alpine rootfs squashfs ───────────────────────────────-FROM alpine:3.23 AS builder+FROM alpine:3.24 AS builder-ARG ALPINE_RELEASE=3.23.4+ARG ALPINE_RELEASE=3.24.1ARG ALPINE_ARCH=aarch64RUN apk add --no-cache curl squashfs-tools tar openssl libcap-utilsdiff --git a/build-rootfs/build-rootfs.sh b/build-rootfs/build-rootfs.shindex 81354df..c863f79 100755--- a/build-rootfs/build-rootfs.sh+++ b/build-rootfs/build-rootfs.sh@@ -2,9 +2,9 @@set -euROOTFS=/work/rootfs-# ALPINE_VERSION comes from the Dockerfile ENV (full release like 3.23.4).-# Strip the patch component to get the major branch (e.g. 3.23) used in repo URLs.-: "${ALPINE_VERSION:?ALPINE_VERSION must be set (e.g. 3.23.4)}"+# ALPINE_VERSION comes from the Dockerfile ENV (full release like 3.24.1).+# Strip the patch component to get the major branch (e.g. 3.24) used in repo URLs.+: "${ALPINE_VERSION:?ALPINE_VERSION must be set (e.g. 3.24.1)}"ALPINE_BRANCH="${ALPINE_VERSION%.*}"mkdir -p "$ROOTFS/etc/apk"diff --git a/docs/guide/how-it-works.html b/docs/guide/how-it-works.htmlindex 8da7f5d..169b9bf 100644--- a/docs/guide/how-it-works.html+++ b/docs/guide/how-it-works.html@@ -49,7 +49,7 @@<main class="content"><h1>How it works</h1>- <p class="lead">Podroid is a real virtual machine, not a translation layer or a container trick. An Alpine Linux 3.23 guest running a custom Linux 7.0.10 kernel boots inside the Android app, with full process isolation and a persistent filesystem.</p>+ <p class="lead">Podroid is a real virtual machine, not a translation layer or a container trick. An Alpine Linux 3.24 guest running a custom Linux 7.1.5 kernel boots inside the Android app, with full process isolation and a persistent filesystem.</p><h2>A real VM</h2><p>When you tap "Start VM", the app launches a real hypervisor with a real aarch64 Alpine Linux guest. The guest kernel, the init system, the shell, and every process you run are all executing real ARM64 machine code inside a fully virtualized machine. There is no instruction translation of Alpine binaries, no Android kernel namespace trick, and no chroot. The guest sees a completely clean Linux environment.</p>@@ -109,7 +109,7 @@</thead><tbody><tr>- <td>Linux 7.0.10 kernel</td>+ <td>Linux 7.1.5 kernel</td><td>Custom-built arm64 guest kernel with overlayfs, cgroups v2, netfilter, FUSE, and VETH built in</td></tr><tr>diff --git a/docs/guide/index.html b/docs/guide/index.htmlindex 373f055..b10a761 100644--- a/docs/guide/index.html+++ b/docs/guide/index.html@@ -49,7 +49,7 @@<main class="content"><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 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.1.5 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 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>diff --git a/docs/guide/packages.html b/docs/guide/packages.htmlindex fbeb182..f18b75d 100644--- a/docs/guide/packages.html+++ b/docs/guide/packages.html@@ -52,7 +52,7 @@<p class="lead">The VM is a standard Alpine Linux system. Install packages with <code>apk</code> as you would on any Alpine machine. Changes persist across reboots on the writable ext4 overlay.</p><h2>Package management with apk</h2>- <p>Both the <strong>main</strong> and <strong>community</strong> repositories are pre-configured in <code>/etc/apk/repositories</code>. Any package available on Alpine 3.23 for aarch64 can be installed directly.</p>+ <p>Both the <strong>main</strong> and <strong>community</strong> repositories are pre-configured in <code>/etc/apk/repositories</code>. Any package available on Alpine 3.24 for aarch64 can be installed directly.</p><table><thead>diff --git a/docs/index.html b/docs/index.htmlindex 8f95332..5fd0e6a 100644--- a/docs/index.html+++ b/docs/index.html@@ -4,7 +4,7 @@<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 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 name="description" content="Podroid runs Podman, Docker, and LXC on Android in a real Alpine Linux VM with a custom Linux 7.1.5 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 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" />@@ -608,7 +608,7 @@<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 7.0.10 Kernel</h3>+ <h3>Custom Linux 7.1.5 Kernel</h3><p>Compiled from scratch with netfilter, bridge, overlayfs, veth, IPVS, VXLAN, IPsec, cgroup v2, and binfmt_misc all built-in. Docker's <code>check-config.sh</code> reports zero fixable complaints.</p></div>@@ -766,7 +766,7 @@</tr><tr><td class="row-label">Custom kernel</td>- <td class="col-podroid"><span class="check">✓ Linux 7.0.10</span></td>+ <td class="col-podroid"><span class="check">✓ Linux 7.1.5</span></td><td><span class="cross">✗ host kernel</span></td><td><span class="check">✓</span></td></tr>@@ -828,11 +828,11 @@└───────────┼─────────────────────┼─────────────────────┼──────────────┘│ │ ││ ┌─────────────────▼────────────────┐ │- │ │ Alpine Linux 3.23 VM │ │+ │ │ Alpine Linux 3.24 VM │ ││ │ /sbin/init (busybox) │ ││ │ OpenRC (PID 1) │ ││ │ ┌──────────┐ ┌──────────────┐ │ │- │ │ │ Podman + │ │ Linux 7.0.10 │ │ │+ │ │ │ Podman + │ │ Linux 7.1.5 │ │ │└──►│ │ Docker │ │ (custom) │ │◄───┘boot stages │ │ + LXC │ └──────────────┘ │ libpodroid-bridge.so│ └──────────┘ │ PTY ↔ virtio-console@@ -852,7 +852,7 @@ qmp.sock → runtime port-forward control</div><div class="step-num">1</div><div class="step-body"><h4>QEMU loads the kernel</h4>- <p>Custom Linux 7.0.10 + a tiny initramfs and an Alpine squashfs are extracted from APK assets on first launch.</p>+ <p>Custom Linux 7.1.5 + a tiny initramfs and an Alpine squashfs are extracted from APK assets on first launch.</p></div></div><div class="step">diff --git a/gradle.properties b/gradle.propertiesindex 37e654c..6b740b9 100644--- a/gradle.properties+++ b/gradle.properties@@ -22,4 +22,4 @@ org.gradle.caching=true# Kotlin code style for this project: "official" or "obsolete":kotlin.code.style=officialpodroidQemuVersion=11.0.0-podroidKernelVersion=7.0.10+podroidKernelVersion=7.1.5