Skip to content

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.md
index 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.md
index 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 iss
These 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/Dockerfile
index 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.5
ENV DEBIAN_FRONTEND=noninteractive
RUN 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 downloader
RUN apk add --no-cache wget cpio gzip tar xorriso
WORKDIR /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-builder
RUN 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 /init
RUN 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 packer
RUN apk add --no-cache cpio gzip findutils
COPY --from=kernel-builder /output/vmlinuz-virt /output/vmlinuz-virt
COPY --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.kt
index 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.current
PodroidGhostButton(
diff --git a/build-rootfs/Dockerfile.rootfs b/build-rootfs/Dockerfile.rootfs
index 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-builder
RUN apk add --no-cache musl-dev gcc make linux-headers
WORKDIR /work
COPY vsock-agent /work/vsock-agent
@@ -13,9 +13,9 @@ COPY overlay-normalize /work/overlay-normalize
RUN 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.1
ARG ALPINE_ARCH=aarch64
RUN apk add --no-cache curl squashfs-tools tar openssl libcap-utils
diff --git a/build-rootfs/build-rootfs.sh b/build-rootfs/build-rootfs.sh
index 81354df..c863f79 100755
--- a/build-rootfs/build-rootfs.sh
+++ b/build-rootfs/build-rootfs.sh
@@ -2,9 +2,9 @@
set -eu
ROOTFS=/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.html
index 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.html
index 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.html
index 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.html
index 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.properties
index 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=official
podroidQemuVersion=11.0.0
-podroidKernelVersion=7.0.10
+podroidKernelVersion=7.1.5