Skip to content

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

feat: custom Linux 6.6.87 kernel + QEMU 11.0.0-rc2 from scratch on Android NDK

ExTv6d54681809a6
diff --git a/Dockerfile b/Dockerfile
index 3654f9d..6f69875 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,8 +1,46 @@
# ─────────────────────────────────────────────────────────────────────────────
# Podroid Unified Dockerfile
-# Combines Initramfs (Alpine VM) and QEMU (Android ARM64) build stages.
+# Combines Custom Kernel, Initramfs (Alpine VM) and QEMU (Android ARM64) builds.
# ─────────────────────────────────────────────────────────────────────────────
+# ==============================================================================
+# SECTION 0: Custom Kernel Build (aarch64) — Image + modules
+# ==============================================================================
+FROM debian:bookworm AS kernel-builder
+ARG KERNEL_VERSION=6.6.87
+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 \
+ bc bison flex libssl-dev libelf-dev python3 kmod cpio \
+ && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /build
+RUN wget -q https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-${KERNEL_VERSION}.tar.xz \
+ && tar xf linux-${KERNEL_VERSION}.tar.xz \
+ && rm linux-${KERNEL_VERSION}.tar.xz
+
+COPY podroid_kernel.config /tmp/podroid_kernel.config
+RUN cd linux-${KERNEL_VERSION} \
+ && make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- defconfig \
+ && ./scripts/kconfig/merge_config.sh -m .config /tmp/podroid_kernel.config \
+ && make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- olddefconfig \
+ && make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) Image.gz modules
+
+RUN cd linux-${KERNEL_VERSION} \
+ && make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- \
+ INSTALL_MOD_PATH=/modules INSTALL_MOD_STRIP=1 modules_install \
+ && rm -f /modules/lib/modules/*/build /modules/lib/modules/*/source
+# Keep only modules init-podroid actually uses; everything else (DSA, pinctrl,
+# mediatek, renesas, hardware-specific drivers) is dead weight in a VM.
+# init-podroid runs `depmod -a` at boot so we don't need to regenerate modules.dep here.
+RUN cd /modules/lib/modules/*/kernel \
+ && find . -name '*.ko' | grep -vE '(^\./net/(bridge|netfilter|9p|ipv4/netfilter|ipv6/netfilter)/|^\./fs/(9p|fuse|overlayfs)/|^\./drivers/net/(tun|veth|virtio_net)\.ko|^\./drivers/block/virtio_blk\.ko|^\./drivers/char/hw_random/virtio-rng\.ko|^\./drivers/virtio/)' \
+ | xargs rm -f \
+ && find . -type d -empty -delete
+
+RUN mkdir -p /output \
+ && cp linux-${KERNEL_VERSION}/arch/arm64/boot/Image.gz /output/vmlinuz-virt
+
# ==============================================================================
# SECTION 1: Initramfs (Alpine VM) Build
# ==============================================================================
@@ -16,25 +54,27 @@ RUN wget -q https://dl-cdn.alpinelinux.org/alpine/v3.23/releases/aarch64/alpine-
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
-# Stage 2: Build the custom rootfs (aarch64)
+# 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
RUN apk update && apk add --no-cache \
- linux-virt bash busybox busybox-extras ttyd podman podman-remote \
+ bash busybox busybox-extras ttyd podman podman-remote \
netavark aardvark-dns fuse-overlayfs slirp4netns iptables ip6tables \
shadow-uidmap ca-certificates crun curl e2fsprogs util-linux openrc \
- dropbear ncurses-terminfo-base musl-locales
+ dropbear ncurses-terminfo-base musl-locales kmod
COPY init-podroid /init
RUN chmod +x /init
-RUN VER=$(apk info -ve linux-virt | head -1 | sed 's/^linux-virt-//') && \
- sed -i "s/^linux-virt$/linux-virt=$VER/" /etc/apk/world
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
RUN apk add --no-cache cpio gzip findutils
-COPY --from=rootfs-builder /boot/vmlinuz-virt /output/vmlinuz-virt
+COPY --from=kernel-builder /output/vmlinuz-virt /output/vmlinuz-virt
COPY --from=rootfs-builder / /rootfs/
-RUN rm -rf /rootfs/proc/* /rootfs/sys/* /rootfs/dev/* /rootfs/run/* /rootfs/tmp/* /rootfs/boot
+# Install kernel modules matching the custom kernel
+COPY --from=kernel-builder /modules/lib/modules /rootfs/lib/modules
+# Strip ephemeral dirs and boot dir
+RUN rm -rf /rootfs/proc/* /rootfs/sys/* /rootfs/dev/* /rootfs/run/* \
+ /rootfs/tmp/* /rootfs/boot
RUN cd /rootfs && find . | cpio -o -H newc 2>/dev/null | gzip -9 > /output/initrd.img
# ==============================================================================
@@ -96,11 +136,23 @@ RUN wget -q https://download.savannah.gnu.org/releases/attr/attr-2.5.2.tar.gz &&
RUN git clone --depth=1 https://github.com/kaniini/libucontext.git /tmp/libucontext && make -C /tmp/libucontext ARCH=aarch64 CC="${CC}" EXPORT_UNPREFIXED=yes && install -Dm644 /tmp/libucontext/libucontext.a ${PREFIX}/lib/libucontext.a && install -Dm644 /tmp/libucontext/include/libucontext/libucontext.h ${PREFIX}/include/libucontext/libucontext.h && install -Dm644 /tmp/libucontext/arch/common/include/libucontext/bits.h ${PREFIX}/include/libucontext/bits.h \
&& printf '#ifndef PODROID_UCONTEXT_SHIM_H\n#define PODROID_UCONTEXT_SHIM_H\n#include_next <ucontext.h>\n#include <libucontext/libucontext.h>\n#define getcontext libucontext_getcontext\n#define makecontext libucontext_makecontext\n#define setcontext libucontext_setcontext\n#define swapcontext libucontext_swapcontext\n#endif\n' > ${PREFIX}/include/ucontext.h
-# QEMU Build
+# QEMU Build (committed flags — no LTO, no -O3 — plus minimal Android compat patches)
RUN wget -q https://download.qemu.org/${QEMU_DIR}.tar.xz && tar xf ${QEMU_DIR}.tar.xz
RUN sed -i "s/rt = cc.find_library('rt', required: true)/rt = cc.find_library('rt', required: false)/" ${QEMU_DIR}/meson.build
RUN printf '#undef st_atime_nsec\n#undef st_mtime_nsec\n#undef st_ctime_nsec\n' | cat - ${QEMU_DIR}/fsdev/9p-marshal.h > /tmp/9p-marshal.h && mv /tmp/9p-marshal.h ${QEMU_DIR}/fsdev/9p-marshal.h
-RUN cd ${QEMU_DIR} && ./configure --cc="${CC}" --cross-prefix="${LLVM}/bin/llvm-" --extra-cflags="-fPIC -DANDROID -I${PREFIX}/include -I${PREFIX}/include/glib-2.0 -I${PREFIX}/lib/glib-2.0/include" --extra-ldflags="-L${PREFIX}/lib -Wl,-z,max-page-size=16384 ${PREFIX}/lib/libucontext.a" --prefix=/opt/qemu-out --target-list=aarch64-softmmu --enable-tcg --enable-slirp --enable-virtfs --enable-pie --disable-docs --disable-gtk --disable-sdl --disable-vnc --disable-vhost-user --with-coroutine=ucontext && make -j$(nproc) install
+# ivshmem-{server,client} also call shm_open; stub their meson.build files since we don't ship them
+RUN printf '# disabled for Android Bionic\n' > ${QEMU_DIR}/contrib/ivshmem-server/meson.build \
+ && printf '# disabled for Android Bionic\n' > ${QEMU_DIR}/contrib/ivshmem-client/meson.build
+# shm_open/shm_unlink are absent from the NDK API-28 stubs.
+# Shim header: forward-declares them for all QEMU TUs.
+# libshm.a: provides an implementation via memfd_create (works on all Android 8+ kernels).
+RUN printf '#ifndef PODROID_SHM_SHIM_H\n#define PODROID_SHM_SHIM_H\nextern int shm_open(const char *, int, unsigned);\nextern int shm_unlink(const char *);\n#endif\n' \
+ > /opt/shm_shim.h
+RUN printf '#include <sys/syscall.h>\n#include <unistd.h>\n#include <errno.h>\n#ifndef SYS_memfd_create\n#define SYS_memfd_create 279\n#endif\nint shm_open(const char *n, int f, unsigned m) {\n (void)f; (void)m;\n while (*n == '"'"'/'"'"') n++;\n long fd = syscall(SYS_memfd_create, n, 0);\n if (fd < 0) { errno = (int)(-fd); return -1; }\n return (int)fd;\n}\nint shm_unlink(const char *n) { (void)n; return 0; }\n' \
+ > /tmp/shm_stub.c \
+ && ${CC} --sysroot=${LLVM}/sysroot -target aarch64-linux-android28 -c /tmp/shm_stub.c -o /tmp/shm_stub.o \
+ && ${AR} rcs ${PREFIX}/lib/libshm.a /tmp/shm_stub.o
+RUN cd ${QEMU_DIR} && ./configure --cc="${CC}" --cross-prefix="${LLVM}/bin/llvm-" --extra-cflags="-fPIC -DANDROID -include /opt/shm_shim.h -I${PREFIX}/include -I${PREFIX}/include/glib-2.0 -I${PREFIX}/lib/glib-2.0/include" --extra-ldflags="-L${PREFIX}/lib -Wl,-z,max-page-size=16384 ${PREFIX}/lib/libucontext.a ${PREFIX}/lib/libshm.a" --prefix=/opt/qemu-out --target-list=aarch64-softmmu --enable-tcg --enable-slirp --enable-virtfs --enable-pie --disable-docs --disable-gtk --disable-sdl --disable-vnc --disable-vhost-user --disable-plugins --with-coroutine=ucontext && make -j$(nproc) install
# Bridge
COPY podroid-bridge.c /tmp/podroid-bridge.c
diff --git a/build-all.sh b/build-all.sh
index eb899b8..624c2b9 100755
--- a/build-all.sh
+++ b/build-all.sh
@@ -29,8 +29,9 @@ Podroid Unified Build Tool
Usage: $0 [command] [options]
Commands:
- all Build everything (Initramfs, QEMU, Termux JNI, APK)
- initramfs Build Alpine VM initramfs (vmlinuz + initrd)
+ all Build everything (Kernel, Initramfs, QEMU, Termux JNI, APK)
+ kernel Build custom kernel only (podroid_kernel.config + Linux source)
+ initramfs Build custom kernel + Alpine VM initramfs (vmlinuz + initrd)
qemu Build QEMU + podroid-bridge
termux Build libtermux.so (16KB page aligned)
apk Build the Android APK
@@ -83,10 +84,30 @@ EOF
# ── Build Functions ───────────────────────────────────────────────────────────
+build_kernel() {
+ local kernel_ver
+ kernel_ver=$(grep -E '^podroidKernelVersion=' "${SCRIPT_DIR}/gradle.properties" | cut -d= -f2)
+ log "Building custom kernel ${kernel_ver} for aarch64 (Docker)..."
+ docker build --network=host \
+ --build-arg "KERNEL_VERSION=${kernel_ver}" \
+ -t podroid-kernel-builder --target kernel-builder "$SCRIPT_DIR"
+ log "Extracting kernel artifact..."
+ docker rm -f podroid-kernel-extract 2>/dev/null || true
+ docker create --name podroid-kernel-extract podroid-kernel-builder
+ mkdir -p "$ASSETS"
+ docker cp podroid-kernel-extract:/output/vmlinuz-virt "$ASSETS/vmlinuz-virt"
+ docker rm podroid-kernel-extract >/dev/null
+ success "Custom kernel ready."
+}
+
build_initramfs() {
- log "Building Alpine Initramfs (Docker)..."
- docker build -t podroid-builder --target packer "$SCRIPT_DIR"
-
+ local kernel_ver
+ kernel_ver=$(grep -E '^podroidKernelVersion=' "${SCRIPT_DIR}/gradle.properties" | cut -d= -f2)
+ log "Building custom kernel + Alpine Initramfs (Docker)..."
+ docker build --network=host \
+ --build-arg "KERNEL_VERSION=${kernel_ver}" \
+ -t podroid-builder --target packer "$SCRIPT_DIR"
+
log "Extracting initramfs artifacts..."
docker rm podroid-extract 2>/dev/null || true
docker create --name podroid-extract podroid-builder /bin/true
@@ -94,7 +115,7 @@ build_initramfs() {
docker cp podroid-extract:/output/vmlinuz-virt "$ASSETS/vmlinuz-virt"
docker cp podroid-extract:/output/initrd.img "$ASSETS/initrd.img"
docker rm podroid-extract >/dev/null
- success "Initramfs ready."
+ success "Kernel + initramfs ready."
}
build_qemu() {
@@ -107,7 +128,7 @@ build_qemu() {
log "Extracting QEMU artifacts..."
docker rm -f podroid-qemu-extract 2>/dev/null || true
- docker create --name podroid-qemu-extract podroid-qemu-builder
+ docker create --name podroid-qemu-extract podroid-qemu-builder /bin/true
mkdir -p "$JNILIBS" "$ASSETS/qemu/keymaps"
docker cp podroid-qemu-extract:/libqemu-system-aarch64.so "$JNILIBS/"
@@ -232,6 +253,7 @@ FAST=false
for arg in "$@"; do [ "$arg" == "--fast" ] && FAST=true; done
case "$1" in
+ kernel) build_kernel ;;
initramfs) build_initramfs ;;
qemu) build_qemu ;;
termux) build_termux ;;
diff --git a/gradle.properties b/gradle.properties
index 4d7391e..212bd86 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -14,3 +14,4 @@ org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
# Kotlin code style for this project: "official" or "obsolete":
kotlin.code.style=official
podroidQemuVersion=11.0.0-rc2
+podroidKernelVersion=6.6.87
diff --git a/init-podroid b/init-podroid
index 1acd363..ed83696 100755
--- a/init-podroid
+++ b/init-podroid
@@ -1,98 +1,98 @@
#!/bin/bash
-# Podroid init — persistent Alpine Linux VM with Podman
-# Two-phase: Phase 1 mounts the overlay, Phase 2 runs the main system.
+# Podroid init — Alpine Linux VM bootstrap
+# Phase 1 (direct exec): mounts persistent overlay, pivots via chroot
+# Phase 2 (--main): full system setup, starts getty
# ══════════════════════════════════════════════════════════════════════════════
-# Phase 2: Main init (running inside persistent overlay)
+# Phase 2: Main system init (inside persistent overlay)
# ══════════════════════════════════════════════════════════════════════════════
if [ "$1" = "--main" ]; then
-# ── Boot stage output (for Android UI detection) ─────────────────────────────
-mkdir -p /run
-boot_stage() { echo "$*" > /run/boot_stage 2>/dev/null; echo "$*"; }
+mkdir -p /run /var/log
+_ILOG=/var/log/init.log
+_log() { printf '%s %s\n' "$(date +%H:%M:%S)" "$*" >> "$_ILOG" 2>/dev/null; }
+boot_stage() { printf '%s\n' "$*" > /run/boot_stage 2>/dev/null; printf '[%s] %s\n' "$(date +%H:%M:%S)" "$*"; }
boot_stage "Initializing system..."
-# ── Init logging (silent unless error) ───────────────────────────────────────
-_LOG=/tmp/init-early.log
-log() { printf "%s %s\n" "$(date '+%H:%M:%S' 2>/dev/null)" "$*" >> "$_LOG" 2>/dev/null; }
-log_error() { printf "[init] ERROR: %s\n" "$*"; log "ERROR: $*"; }
+# ── Core filesystems ──────────────────────────────────────────────────────────
+mount -t proc proc /proc -o noexec,nosuid,nodev 2>/dev/null
+mount -t sysfs sys /sys -o noexec,nosuid,nodev 2>/dev/null
+mount -t devtmpfs devtmpfs /dev -o exec,nosuid,mode=0755,size=2M 2>/dev/null || \
+ mount -t tmpfs tmpfs /dev -o exec,nosuid,mode=0755,size=2M 2>/dev/null
-# ── Core filesystems ───────────────────────────────────────────────────────────
-mount -t proc proc /proc -o noexec,nosuid,nodev 2>/dev/null
-mount -t sysfs sys /sys -o noexec,nosuid,nodev 2>/dev/null
-mount -t devtmpfs devtmpfs /dev -o exec,nosuid,mode=0755,size=2M 2>/dev/null || \
- mount -t tmpfs tmpfs /dev -o exec,nosuid,mode=0755,size=2M 2>/dev/null
mkdir -p /dev/pts /dev/shm /dev/mqueue /dev/net 2>/dev/null
-# devpts with newinstance - REQUIRED for PTY in containers
+# newinstance devpts — required for PTY isolation in containers
mount -t devpts devpts /dev/pts \
-o gid=5,mode=0620,ptmxmode=0666,newinstance,noexec,nosuid 2>/dev/null || \
- log_error "Failed to mount devpts"
+ _log "devpts mount failed"
-# Create ptmx as real char device (not symlink) - REQUIRED for crun
+# Real ptmx char device — required for crun PTY allocation
rm -f /dev/ptmx 2>/dev/null
-mknod /dev/ptmx c 5 2 2>/dev/null || log_error "Failed to create /dev/ptmx"
+mknod /dev/ptmx c 5 2 2>/dev/null || _log "mknod /dev/ptmx failed"
chmod 0666 /dev/ptmx /dev/pts/ptmx 2>/dev/null
-mount -t tmpfs tmpfs /dev/shm -o noexec,nosuid,nodev,size=64m 2>/dev/null
-mount -t tmpfs tmpfs /tmp -o noexec,nosuid,nodev 2>/dev/null
-mount -t tmpfs tmpfs /run -o noexec,nosuid,nodev,mode=0755 2>/dev/null
+mount -t tmpfs tmpfs /dev/shm -o noexec,nosuid,nodev,size=64m 2>/dev/null
+mount -t tmpfs tmpfs /tmp -o noexec,nosuid,nodev 2>/dev/null
+mount -t tmpfs tmpfs /run -o noexec,nosuid,nodev,mode=0755 2>/dev/null
-# ── cgroup2 (REQUIRED for Podman on Alpine) ─────────────────────────────────
-mkdir -p /sys/fs/cgroup
+# ── cgroup2 ───────────────────────────────────────────────────────────────────
+mkdir -p /sys/fs/cgroup 2>/dev/null
mount -t cgroup2 cgroup2 /sys/fs/cgroup 2>/dev/null
-if [ -f /sys/fs/cgroup/cgroup.subtree_control ]; then
- for ctrl in cpuset cpu io memory hugetlb pids rdma misc; do
- echo "+$ctrl" > /sys/fs/cgroup/cgroup.subtree_control 2>/dev/null
- done
-fi
+printf '+cpuset +cpu +io +memory +hugetlb +pids +rdma\n' \
+ > /sys/fs/cgroup/cgroup.subtree_control 2>/dev/null
-# ── Busybox + dirs ────────────────────────────────────────────────────────────
+# ── Busybox + directory tree ──────────────────────────────────────────────────
/bin/busybox --install -s 2>/dev/null
-
-# Make sh point to bash (Alpine uses sh by default)
ln -sf /bin/bash /bin/sh 2>/dev/null
-mkdir -p /var/lib/containers/storage /var/log /var/tmp /root
-mkdir -p /run/lock /run/containers/storage /run/libpod /run/crun
-mkdir -p /usr/local/bin /usr/local/sbin 2>/dev/null
-chmod 700 /root
-chmod 1777 /tmp /var/tmp
-cp "$_LOG" /var/log/init.log 2>/dev/null && _LOG=/var/log/init.log
+mkdir -p \
+ /var/lib/containers/storage \
+ /run/containers/storage /run/libpod /run/crun /run/lock \
+ /etc/containers /etc/dropbear /etc/crun \
+ /mnt/downloads \
+ /usr/local/bin /usr/local/sbin \
+ /root /root/.ssh /var/tmp 2>/dev/null
-# ── Hostname + hosts ─────────────────────────────────────────────────────────
-echo "podroid" > /etc/hostname 2>/dev/null
+chmod 700 /root /root/.ssh 2>/dev/null
+chmod 1777 /tmp /var/tmp 2>/dev/null
+
+printf 'podroid\n' > /etc/hostname
hostname podroid 2>/dev/null
-cat > /etc/hosts <<'HOSTS'
-127.0.0.1 localhost podroid
-::1 localhost ip6-localhost ip6-loopback
-HOSTS
+printf '127.0.0.1\tlocalhost podroid\n::1\tlocalhost ip6-localhost\n' > /etc/hosts
-# ── Kernel modules (silent) ─────────────────────────────────────────────────
+# ── Kernel modules + device nodes ────────────────────────────────────────────
boot_stage "Loading kernel modules..."
-KVER=$(uname -r)
-if [ -d "/lib/modules/$KVER" ]; then
+_kver=$(uname -r)
+if [ -d "/lib/modules/$_kver" ]; then
depmod -a 2>/dev/null
- for mod in \
+ for _mod in \
virtio_net virtio_blk fuse tun veth \
bridge br_netfilter overlay \
xt_addrtype xt_conntrack xt_nat xt_mark xt_comment \
nf_nat nf_conntrack nf_conntrack_netlink nfnetlink \
ip_tables ip6_tables ip6table_nat \
9p 9pnet 9pnet_virtio; do
- modprobe "$mod" 2>/dev/null
+ modprobe "$_mod" 2>/dev/null
done
fi
-# Ensure required device nodes exist
-[ ! -c /dev/net/tun ] && mknod /dev/net/tun c 10 200 2>/dev/null
-[ ! -c /dev/fuse ] && mknod /dev/fuse c 10 229 2>/dev/null
-
-# ── Read kernel cmdline params ───────────────────────────────────────────────
-ANDROID_IP=""
-SSH_ENABLED=0
-for param in $(cat /proc/cmdline); do
- case "$param" in
- androidip=*) ANDROID_IP="${param#androidip=}" ;;
+[ -c /dev/net/tun ] || mknod /dev/net/tun c 10 200 2>/dev/null
+[ -c /dev/fuse ] || mknod /dev/fuse c 10 229 2>/dev/null
+
+# ── ZRAM swap (built-in; half RAM at lz4) ────────────────────────────────────
+if [ -b /dev/zram0 ]; then
+ _mem_kb=$(awk '/^MemTotal:/{print $2}' /proc/meminfo)
+ echo lz4 > /sys/block/zram0/comp_algorithm 2>/dev/null || \
+ echo lzo-rle > /sys/block/zram0/comp_algorithm 2>/dev/null
+ echo $(( _mem_kb * 512 )) > /sys/block/zram0/disksize 2>/dev/null
+ mkswap /dev/zram0 >/dev/null 2>&1 && swapon -p 100 /dev/zram0 2>/dev/null
+fi
+
+# ── Kernel cmdline ────────────────────────────────────────────────────────────
+ANDROID_IP="" SSH_ENABLED=0
+for _p in $(cat /proc/cmdline); do
+ case "$_p" in
+ androidip=*) ANDROID_IP="${_p#androidip=}" ;;
ssh=1) SSH_ENABLED=1 ;;
esac
done
@@ -101,68 +101,58 @@ done
boot_stage "Waiting for network..."
ip link set lo up 2>/dev/null
NETIF=""
-for i in $(seq 1 30); do
- NETIF=$(ip -o link show 2>/dev/null | awk -F': ' '{print $2}' | grep -v lo | head -1)
+for _i in $(seq 1 150); do
+ NETIF=$(ip -o link show 2>/dev/null | awk -F': ' '{print $2}' | \
+ grep -vE '^(lo|dummy[0-9]*|sit[0-9]*|gre[0-9]*|tunl[0-9]*|br-|veth|podman|cni-)' | head -1)
[ -n "$NETIF" ] && break
- sleep 1
+ sleep 0.2
done
if [ -n "$NETIF" ]; then
- ip link set dev "$NETIF" up 2>/dev/null
+ ip link set "$NETIF" up 2>/dev/null
ip addr add 10.0.2.15/24 dev "$NETIF" 2>/dev/null
ip route add default via 10.0.2.2 dev "$NETIF" 2>/dev/null
- boot_stage "Network found"
else
- log_error "No network interface found after 30s"
- boot_stage "Network found"
+ _log "No network interface found after 30s"
fi
+boot_stage "Network found"
-cat > /etc/resolv.conf <<'DNS'
-nameserver 10.0.2.3
-nameserver 8.8.8.8
-nameserver 1.1.1.1
-DNS
+printf 'nameserver 10.0.2.3\nnameserver 8.8.8.8\nnameserver 1.1.1.1\n' > /etc/resolv.conf
-# ── Downloads folder (9p) ─────────────────────────────────────────────────────
-mkdir -p /mnt/downloads
-mount -t 9p \
- -o trans=virtio,version=9p2000.L,rw,msize=1048576,cache=loose,noatime \
- downloads /mnt/downloads 2>/dev/null
+# 9p downloads — non-critical, mount in background
+mount -t 9p -o trans=virtio,version=9p2000.L,rw,msize=1048576,cache=loose,noatime \
+ downloads /mnt/downloads 2>/dev/null &
-# ── Container configuration ──────────────────────────────────────────────────
+# ── Container setup ───────────────────────────────────────────────────────────
boot_stage "Configuring containers..."
-# Container sysctls (Alpine/Podman best practices)
-sysctl -qw net.ipv4.ip_forward=1 2>/dev/null
-sysctl -qw net.ipv4.conf.all.forwarding=1 2>/dev/null
-sysctl -qw net.bridge.bridge-nf-call-iptables=1 2>/dev/null
-sysctl -qw net.bridge.bridge-nf-call-ip6tables=1 2>/dev/null
+sysctl -qw \
+ net.ipv4.ip_forward=1 \
+ net.ipv4.conf.all.forwarding=1 \
+ net.bridge.bridge-nf-call-iptables=1 \
+ net.bridge.bridge-nf-call-ip6tables=1 \
+ fs.inotify.max_user_instances=256 \
+ fs.inotify.max_user_watches=65536 \
+ net.core.rmem_max=26214400 \
+ net.core.wmem_max=26214400 2>/dev/null
sysctl -qw net.ipv4.ping_group_range="0 2147483647" 2>/dev/null
-sysctl -qw kernel.unprivileged_userns_clone=1 2>/dev/null
-sysctl -qw fs.inotify.max_user_instances=256 2>/dev/null
-sysctl -qw fs.inotify.max_user_watches=65536 2>/dev/null
-sysctl -qw net.core.rmem_max=26214400 2>/dev/null
-sysctl -qw net.core.wmem_max=26214400 2>/dev/null
-
-# Podman configuration (Alpine official recommendations)
-[ -f /etc/subuid ] || echo "root:100000:65536" > /etc/subuid
-[ -f /etc/subgid ] || echo "root:100000:65536" > /etc/subgid
-
-mkdir -p /etc/containers
-cat > /etc/containers/containers.conf <<'CONF'
+
+[ -f /etc/subuid ] || printf 'root:100000:65536\n' > /etc/subuid
+[ -f /etc/subgid ] || printf 'root:100000:65536\n' > /etc/subgid
+
+cat > /etc/containers/containers.conf <<'EOF'
[containers]
cgroups = "enabled"
[engine]
runtime = "crun"
-network_cmd = "/usr/bin/slirp4netns"
events_logger = "file"
[network]
network_backend = "netavark"
-CONF
+EOF
-cat > /etc/containers/storage.conf <<'CONF'
+cat > /etc/containers/storage.conf <<'EOF'
[storage]
driver = "overlay"
runroot = "/run/containers/storage"
@@ -170,115 +160,92 @@ graphroot = "/var/lib/containers/storage"
[storage.options.overlay]
mount_program = "/usr/bin/fuse-overlayfs"
-CONF
-
-cat > /etc/containers/registries.conf <<'CONF'
-unqualified-search-registries = ["docker.io", "quay.io"]
-CONF
+EOF
-mkdir -p /etc/crun
-[ -f /etc/crun/crun.conf ] || touch /etc/crun/crun.conf
+printf 'unqualified-search-registries = ["docker.io", "quay.io"]\n' \
+ > /etc/containers/registries.conf
+touch /etc/crun/crun.conf 2>/dev/null
-# ── SSH setup (Dropbear) ──────────────────────────────────────────────────────
+# ── SSH (Dropbear) ────────────────────────────────────────────────────────────
if [ "$SSH_ENABLED" = "1" ]; then
boot_stage "Starting SSH..."
if [ ! -f /etc/podroid-ssh-init ]; then
- echo "root:podroid" | chpasswd 2>/dev/null
+ printf 'root:podroid\n' | chpasswd 2>/dev/null
touch /etc/podroid-ssh-init
fi
-
- mkdir -p /etc/dropbear
- if [ ! -f /etc/dropbear/dropbear_rsa_host_key ]; then
- dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key >/dev/null 2>&1
- fi
-
- mkdir -p /root/.ssh
- chmod 700 /root/.ssh
+ rm -f /etc/dropbear/dropbear_rsa_host_key 2>/dev/null
+ [ -f /etc/dropbear/dropbear_ed25519_host_key ] || \
+ dropbearkey -t ed25519 -f /etc/dropbear/dropbear_ed25519_host_key >/dev/null 2>&1
dropbear -p 22 >/dev/null 2>&1
fi
-# ── Environment ────────────────────────────────────────────────────────────────
+# ── Environment ───────────────────────────────────────────────────────────────
export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
-export HOME=/root
-export TERM=xterm-256color
-export LANG=C.UTF-8
-export LC_ALL=C.UTF-8
-export CHARSET=UTF-8
+export HOME=/root TERM=xterm-256color LANG=C.UTF-8 LC_ALL=C.UTF-8 CHARSET=UTF-8
export PODMAN_IGNORE_CGROUPSV1_WARNING=1
export CONTAINERS_CONF=/etc/containers/containers.conf
export CONTAINERS_STORAGE_CONF=/etc/containers/storage.conf
export CONTAINERS_REGISTRIES_CONF=/etc/containers/registries.conf
-# ── Console settings ─────────────────────────────────────────────────────────
dmesg -n 1 2>/dev/null
stty rows 24 cols 80 -ixon -ixoff -iexten 2>/dev/null
+trap 'podman stop -a -t 5 2>/dev/null; podman network prune -f 2>/dev/null; sync' TERM INT HUP
-# ── Shutdown handler ─────────────────────────────────────────────────────────
-shutdown_handler() {
- podman stop -a -t 5 2>/dev/null
- podman network prune -f 2>/dev/null
- sync
-}
-trap shutdown_handler TERM INT HUP
+# ── Resize daemon ─────────────────────────────────────────────────────────────
+(
+ for _i in $(seq 1 30); do [ -c /dev/hvc0 ] && break; sleep 1; done
+ [ -c /dev/hvc0 ] || exit 0
+ while IFS= read -r _line; do
+ case "$_line" in
+ RESIZE\ *) set -- $_line; stty rows "$2" cols "$3" </dev/ttyAMA0 2>/dev/null ;;
+ esac
+ done </dev/hvc0
+) &
-# ── Gather system info for MOTD ──────────────────────────────────────────────
+# ── MOTD + profile ────────────────────────────────────────────────────────────
boot_stage "Almost ready..."
-VM_IP=$(ip addr show "$NETIF" 2>/dev/null | grep 'inet ' | awk '{print $2}' | cut -d'/' -f1)
-STORAGE_USED=$(df -BG / 2>/dev/null | awk 'NR==2 {gsub(/G/,"",$3); print $3}')
-STORAGE_TOTAL=$(df -BG / 2>/dev/null | awk 'NR==2 {gsub(/G/,"",$2); print $2}')
-MEM_MB=$(free -m 2>/dev/null | awk '/^Mem:/{print $2}')
-MEM_AVAIL=$(free -m 2>/dev/null | awk '/^Mem:/{print $7}')
-CPUS=$(nproc 2>/dev/null || echo "?")
-KVER_SHORT=$(uname -r | cut -d- -f1)
-UPTIME_SEC=$(cat /proc/uptime 2>/dev/null | cut -d' ' -f1 | cut -d'.' -f1)
-UPTIME_MIN=$((UPTIME_SEC / 60))
-
-# Check internet
-INTERNET="✗"
-if wget -q -O /dev/null --timeout=3 http://dl-cdn.alpinelinux.org/alpine/MIRRORS.txt 2>/dev/null; then
- INTERNET="✓"
-fi
-# ── Enhanced MOTD ───────────────────────────────────────────────────────────
+_kver_s=$(uname -r | cut -d- -f1)
+_mem_mb=$(awk '/^MemTotal:/{printf "%.0f",$2/1024}' /proc/meminfo)
+_mem_free=$(awk '/^MemAvailable:/{printf "%.0f",$2/1024}' /proc/meminfo)
+_cpus=$(nproc)
+_uptime=$(( $(cut -d. -f1 /proc/uptime) / 60 ))
+_disk_used=$(df -BG / 2>/dev/null | awk 'NR==2{gsub(/G/,"",$3);print $3}')
+_disk_total=$(df -BG / 2>/dev/null | awk 'NR==2{gsub(/G/,"",$2);print $2}')
+
if [ "$SSH_ENABLED" = "1" ] && [ -n "$ANDROID_IP" ]; then
- SSH_INFO="
+ _ssh_block="
┌────────────────────────────────────────────────────────────┐
-│ SSH Access │
-│ ssh root@${ANDROID_IP} -p 9922 │
-│ Password: podroid │
+│ SSH: ssh root@${ANDROID_IP} -p 9922 pass: podroid │
└────────────────────────────────────────────────────────────┘"
else
- SSH_INFO=""
+ _ssh_block=""
fi
+# __NET__ is replaced asynchronously once the internet check completes
cat > /etc/motd <<MOTD
╔══════════════════════════════════════════════════════════╗
- ║ Podroid - Alpine Linux Container Runtime ║
+ ║ Podroid · Alpine Linux Container Runtime ║
╚══════════════════════════════════════════════════════════╝
- 📦 System
- Alpine: ${KVER_SHORT} CPU: ${CPUS} cores Memory: ${MEM_AVAIL}/${MEM_MB} MB
- Disk: ${STORAGE_USED}/${STORAGE_TOTAL} GB Net: ${INTERNET} Uptime: ${UPTIME_MIN}m
-
- 🐳 Quick Start
- podman run -it alpine sh # Interactive shell
- podman run -d -p 8080:80 nginx # Run nginx
- podman ps -a # List containers
-
-${SSH_INFO}
+ 📦 Alpine ${_kver_s} · ${_cpus} CPU · ${_mem_free}/${_mem_mb} MB RAM · ${_disk_used}/${_disk_total} GB · Up ${_uptime}m
+ Net: __NET__
+${_ssh_block}
+ 🐳 podman run -it --rm alpine # interactive shell
+ podman run -d -p 8080:80 nginx # background service
+ podman ps -a # list containers
MOTD
-# ── Profile ───────────────────────────────────────────────────────────────────
+{ wget -q -O /dev/null --timeout=2 http://dl-cdn.alpinelinux.org/alpine/MIRRORS.txt 2>/dev/null \
+ && sed -i 's/__NET__/✓ internet/' /etc/motd \
+ || sed -i 's/__NET__/✗ offline/' /etc/motd; } &
+
cat > /etc/profile <<'PROF'
-export HOME=/root
-export SHELL=/bin/bash
+export HOME=/root SHELL=/bin/bash
export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
-export TERM=xterm-256color
-export LANG=C.UTF-8
-export LC_ALL=C.UTF-8
-export CHARSET=UTF-8
+export TERM=xterm-256color LANG=C.UTF-8 LC_ALL=C.UTF-8 CHARSET=UTF-8
export PODMAN_IGNORE_CGROUPSV1_WARNING=1
export CONTAINERS_CONF=/etc/containers/containers.conf
export CONTAINERS_STORAGE_CONF=/etc/containers/storage.conf
@@ -287,62 +254,32 @@ export CONTAINERS_REGISTRIES_CONF=/etc/containers/registries.conf
stty -ixon -ixoff -iexten -echoctl 2>/dev/null
set +o checkwinsize 2>/dev/null
-alias ls='ls --color=auto'
-alias ll='ls -lah --color=auto'
-alias la='ls -A --color=auto'
-alias grep='grep --color=auto'
-alias df='df -h'
-alias free='free -m'
-alias ip='ip -c'
-alias less='less -R'
-alias dps='podman ps -a'
-alias di='podman images'
-alias dlogs='podman logs -f'
-alias dexec='podman exec -it'
-alias drun='podman run --rm -it'
-alias dstop='podman stop'
-alias drm='podman rm'
-alias drmi='podman rmi'
-alias dstats='podman stats'
+alias ls='ls --color=auto' ll='ls -lah --color=auto' la='ls -A --color=auto'
+alias grep='grep --color=auto' df='df -h' free='free -m' ip='ip -c' less='less -R'
+alias dps='podman ps -a' di='podman images' dlogs='podman logs -f'
+alias dexec='podman exec -it' drun='podman run --rm -it'
+alias dstop='podman stop' drm='podman rm' drmi='podman rmi' dstats='podman stats'
PS1='\[\e[1;32m\]➜\[\e[0m\] \[\e[1;34m\]\w\[\e[0m\] \[\e[1;31m\]#\[\e[0m\] '
-
cd /root 2>/dev/null
PROF
-# ── Resize control daemon ────────────────────────────────────────────────────
-(
- for i in $(seq 1 30); do
- [ -c /dev/hvc0 ] && break
- sleep 1
- done
- [ -c /dev/hvc0 ] || exit 0
- while IFS= read -r line; do
- case "$line" in
- RESIZE\ *)
- set -- $line
- stty rows "$2" cols "$3" < /dev/ttyAMA0 2>/dev/null
- ;;
- esac
- done < /dev/hvc0
-) &
-
-# ── Login wrapper (nvim fix: script allocates a real PTY so TUI apps work) ───
-mkdir -p /usr/local/bin
+# ── Login wrapper ─────────────────────────────────────────────────────────────
cat > /usr/local/bin/podroid-login <<'LOGIN'
#!/bin/bash
cat /etc/motd 2>/dev/null
exec /usr/bin/script -q -c 'exec /bin/bash --login' /dev/null
LOGIN
chmod +x /usr/local/bin/podroid-login
-grep -q '^root:' /etc/passwd 2>/dev/null || echo "root:x:0:0:root:/root:/bin/bash" > /etc/passwd
+grep -q '^root:' /etc/passwd 2>/dev/null || \
+ printf 'root:x:0:0:root:/root:/bin/bash\n' > /etc/passwd
boot_stage "Ready!"
rm -f /run/boot_stage
-# Give the Android boot monitor 2 seconds to read "Ready!" before
-# the bridge takes over the serial socket (serial.sock is single-client).
-sleep 2
+# Hand off serial.sock to bridge — monitor reads "Ready!" then disconnects;
+# single-client socket requires this gap before getty takes over.
+sleep 0.5
while true; do
/sbin/getty -n -l /usr/local/bin/podroid-login 0 ttyAMA0 xterm-256color
@@ -351,68 +288,52 @@ done
fi
# ══════════════════════════════════════════════════════════════════════════════
-# Phase 1: Early init — mount persistent storage and pivot to overlay
-# Uses chroot (with proper devpts setup for PTY support)
+# Phase 1: Early init — mount persistent overlay and pivot
# ══════════════════════════════════════════════════════════════════════════════
-mount -t proc proc /proc -o noexec,nosuid,nodev 2>/dev/null
-mount -t sysfs sys /sys -o noexec,nosuid,nodev 2>/dev/null
-mount -t devtmpfs devtmpfs /dev -o exec,nosuid,mode=0755,size=2M 2>/dev/null || \
- mount -t tmpfs tmpfs /dev -o exec,nosuid,mode=0755,size=2M 2>/dev/null
+mount -t proc proc /proc -o noexec,nosuid,nodev 2>/dev/null
+mount -t sysfs sys /sys -o noexec,nosuid,nodev 2>/dev/null
+mount -t devtmpfs devtmpfs /dev -o exec,nosuid,mode=0755,size=2M 2>/dev/null || \
+ mount -t tmpfs tmpfs /dev -o exec,nosuid,mode=0755,size=2M 2>/dev/null
-KVER=$(uname -r)
-if [ -d "/lib/modules/$KVER" ]; then
- depmod -a 2>/dev/null
- modprobe virtio_blk 2>/dev/null
-fi
+_kver=$(uname -r)
+[ -d "/lib/modules/$_kver" ] && { depmod -a 2>/dev/null; modprobe virtio_blk 2>/dev/null; }
echo 1 > /proc/sys/kernel/printk 2>/dev/null
-echo " ╔═══════════════════════════════════════════╗"
-echo " ║ Podroid VM is starting... ║"
-echo " ║ Please wait... ║"
-echo " ╚═══════════════════════════════════════════╝"
-echo ""
-
-mkdir -p /mnt/persist
-PERSIST_DEV=""
-for dev in /dev/vda /dev/vdb; do
- [ -b "$dev" ] || continue
- PERSIST_DEV="$dev"
- break
-done
+printf ' ╔═══════════════════════════════════════════╗\n'
+printf ' ║ Podroid VM is starting... ║\n'
+printf ' ║ Please wait... ║\n'
+printf ' ╚═══════════════════════════════════════════╝\n\n'
-if [ -n "$PERSIST_DEV" ]; then
- if ! mount -t ext4 -o rw,noatime "$PERSIST_DEV" /mnt/persist 2>/dev/null; then
+mkdir -p /mnt/persist /mnt/overlay 2>/dev/null
+
+for _dev in /dev/vda /dev/vdb /dev/vdc; do
+ [ -b "$_dev" ] || continue
+ if ! mount -t ext4 -o rw,noatime "$_dev" /mnt/persist 2>/dev/null; then
/bin/busybox --install -s 2>/dev/null
- e2fsck -y "$PERSIST_DEV" >/dev/null 2>&1
- if ! mount -t ext4 -o rw,noatime "$PERSIST_DEV" /mnt/persist 2>/dev/null; then
- mkfs.ext4 -q -F "$PERSIST_DEV" >/dev/null 2>&1
- mount -t ext4 -o rw,noatime "$PERSIST_DEV" /mnt/persist 2>/dev/null
+ e2fsck -y "$_dev" >/dev/null 2>&1
+ if ! mount -t ext4 -o rw,noatime "$_dev" /mnt/persist 2>/dev/null; then
+ mkfs.ext4 -q -F "$_dev" >/dev/null 2>&1
+ mount -t ext4 -o rw,noatime "$_dev" /mnt/persist 2>/dev/null || continue
fi
fi
+ break
+done
- if mountpoint -q /mnt/persist 2>/dev/null; then
- mkdir -p /mnt/persist/upper /mnt/persist/work /mnt/overlay
-
- mount -t overlay overlay \
- -o lowerdir=/,upperdir=/mnt/persist/upper,workdir=/mnt/persist/work \
- /mnt/overlay 2>/dev/null
-
- if mountpoint -q /mnt/overlay 2>/dev/null; then
- mkdir -p /mnt/overlay/mnt/persist
- mount --bind /mnt/persist /mnt/overlay/mnt/persist
- touch /mnt/persist/.overlay-active
-
- umount /dev 2>/dev/null
- umount /sys 2>/dev/null
- umount /proc 2>/dev/null
- exec chroot /mnt/overlay /init --main
- fi
+if mountpoint -q /mnt/persist 2>/dev/null; then
+ mkdir -p /mnt/persist/upper /mnt/persist/work 2>/dev/null
+ if mount -t overlay overlay \
+ -o lowerdir=/,upperdir=/mnt/persist/upper,workdir=/mnt/persist/work \
+ /mnt/overlay 2>/dev/null; then
+ mkdir -p /mnt/overlay/mnt/persist 2>/dev/null
+ mount --bind /mnt/persist /mnt/overlay/mnt/persist 2>/dev/null
+ touch /mnt/persist/.overlay-active 2>/dev/null
+ umount /dev /sys /proc 2>/dev/null
+ exec /bin/busybox chroot /mnt/overlay /init --main
fi
fi
-umount /dev 2>/dev/null
-umount /sys 2>/dev/null
-umount /proc 2>/dev/null
-exec chroot /mnt/overlay /init --main
+# Fallback: boot without persistent storage (writes go to initramfs tmpfs)
+umount /dev /sys /proc 2>/dev/null
+exec /init --main
diff --git a/podroid_kernel.config b/podroid_kernel.config
new file mode 100644
index 0000000..31d15d7
--- /dev/null
+++ b/podroid_kernel.config
@@ -0,0 +1,205 @@
+# ──────────────────────────────────────────────────────────────────────────────
+# Podroid kernel config fragment — applied on top of arm64 defconfig.
+#
+# Goal: eliminate the 19s modprobe loop by building every required driver
+# directly into the kernel image. No loadable modules needed at runtime.
+#
+# Build flow:
+# make ARCH=arm64 defconfig
+# scripts/kconfig/merge_config.sh -m .config podroid_kernel.config
+# make ARCH=arm64 olddefconfig
+# make ARCH=arm64 -j$(nproc) Image.gz
+# ──────────────────────────────────────────────────────────────────────────────
+
+# ── Initramfs support (required for boot) ────────────────────────────────────
+CONFIG_BLK_DEV_INITRD=y
+CONFIG_RD_GZIP=y
+
+# ── Strip debug info (halves build time and kernel size) ─────────────────────
+CONFIG_DEBUG_INFO_NONE=y
+# CONFIG_DEBUG_INFO is not set
+
+# ── Timer: 100 Hz instead of default 250 Hz, tickless idle ───────────────────
+CONFIG_HZ_100=y
+CONFIG_NO_HZ_IDLE=y
+CONFIG_NO_HZ=y
+
+# ── Scheduler: throughput/server mode, lower context-switch overhead ─────────
+CONFIG_PREEMPT_NONE=y
+
+# ── Transparent huge pages — help memory allocators through TCG ──────────────
+CONFIG_TRANSPARENT_HUGEPAGE=y
+CONFIG_TRANSPARENT_HUGEPAGE_ALWAYS=y
+
+# ── Virtio devices (all built-in — no modprobe at boot) ──────────────────────
+CONFIG_VIRTIO=y
+CONFIG_VIRTIO_PCI=y
+CONFIG_VIRTIO_BLK=y
+CONFIG_VIRTIO_NET=y
+CONFIG_VIRTIO_CONSOLE=y
+CONFIG_HW_RANDOM_VIRTIO=y
+# CONFIG_VIRTIO_BALLOON is not set
+# CONFIG_VIRTIO_INPUT is not set
+
+# ── Block I/O — matches elevator=mq-deadline in kernel cmdline ───────────────
+CONFIG_MQ_IOSCHED_DEADLINE=y
+CONFIG_BLK_CGROUP=y
+CONFIG_BLK_CGROUP_IOCOST=y
+# CONFIG_MQ_IOSCHED_KYBER is not set
+
+# ── Serial console: PL011 UART = ttyAMA0 ─────────────────────────────────────
+CONFIG_SERIAL_AMBA_PL011=y
+CONFIG_SERIAL_AMBA_PL011_CONSOLE=y
+
+# ── Filesystems (built-in) ────────────────────────────────────────────────────
+CONFIG_EXT4_FS=y
+CONFIG_OVERLAY_FS=y
+CONFIG_FUSE_FS=y
+CONFIG_TMPFS=y
+CONFIG_TMPFS_XATTR=y
+CONFIG_DEVTMPFS=y
+CONFIG_DEVTMPFS_MOUNT=y
+# CONFIG_EXT2_FS is not set
+# CONFIG_EXT3_FS is not set
+# CONFIG_BTRFS_FS is not set
+# CONFIG_XFS_FS is not set
+
+# ── virtio-9p: Downloads folder sharing ──────────────────────────────────────
+CONFIG_NET_9P=y
+CONFIG_NET_9P_VIRTIO=y
+CONFIG_9P_FS=y
+
+# ── ZRAM: built-in compressed swap (replaces modprobe zram in init) ───────────
+CONFIG_SWAP=y
+CONFIG_ZSMALLOC=y
+CONFIG_ZRAM=y
+CONFIG_ZRAM_DEF_COMP_LZ4=y
+CONFIG_CRYPTO_LZ4=y
+CONFIG_CRYPTO_LZ4HC=y
+
+# ── Networking: TUN/VETH/bridge (built-in for Podman container networking) ───
+CONFIG_TUN=y
+CONFIG_VETH=y
+CONFIG_BRIDGE=y
+CONFIG_BRIDGE_NETFILTER=y
+CONFIG_BRIDGE_VLAN_FILTERING=y
+CONFIG_VLAN_8021Q=y
+CONFIG_NET_SCHED=y
+CONFIG_NET_SCH_FQ_CODEL=y
+CONFIG_DUMMY=y
+
+# ── Netfilter: full stack needed by netavark + iptables compat ───────────────
+CONFIG_NETFILTER=y
+CONFIG_NETFILTER_ADVANCED=y
+CONFIG_NETFILTER_NETLINK=y
+CONFIG_NETFILTER_NETLINK_LOG=y
+CONFIG_NF_CONNTRACK=y
+CONFIG_NF_CONNTRACK_NETLINK=y
+CONFIG_NF_NAT=y
+
+# nftables (netavark primary backend)
+CONFIG_NF_TABLES=y
+CONFIG_NF_TABLES_INET=y
+CONFIG_NF_TABLES_IPV4=y
+CONFIG_NF_TABLES_IPV6=y
+CONFIG_NF_TABLES_BRIDGE=y
+CONFIG_NF_TABLES_NETDEV=y
+CONFIG_NFT_COUNTER=y
+CONFIG_NFT_CONNLIMIT=y
+CONFIG_NFT_LOG=y
+CONFIG_NFT_LIMIT=y
+CONFIG_NFT_MASQ=y
+CONFIG_NFT_REDIR=y
+CONFIG_NFT_NAT=y
+CONFIG_NFT_CT=y
+CONFIG_NFT_SET_RBTREE=y
+CONFIG_NFT_SET_HASH=y
+
+# iptables (legacy compat layer used by some container tools)
+CONFIG_NETFILTER_XTABLES=y
+CONFIG_IP_NF_IPTABLES=y
+CONFIG_IP_NF_FILTER=y
+CONFIG_IP_NF_NAT=y
+CONFIG_IP_NF_MANGLE=y
+CONFIG_IP6_NF_IPTABLES=y
+CONFIG_IP6_NF_FILTER=y
+CONFIG_IP6_NF_NAT=y
+CONFIG_NETFILTER_XT_MATCH_ADDRTYPE=y
+CONFIG_NETFILTER_XT_MATCH_CONNTRACK=y
+CONFIG_NETFILTER_XT_MATCH_MARK=y
+CONFIG_NETFILTER_XT_MATCH_COMMENT=y
+CONFIG_NETFILTER_XT_TARGET_MASQUERADE=y
+CONFIG_NETFILTER_XT_TARGET_REDIRECT=y
+CONFIG_NETFILTER_XT_TARGET_MARK=y
+
+# ── Cgroups v2 — full set required by Podman ─────────────────────────────────
+CONFIG_CGROUPS=y
+CONFIG_CGROUP_SCHED=y
+CONFIG_CGROUP_PIDS=y
+CONFIG_CGROUP_RDMA=y
+CONFIG_CGROUP_FREEZER=y
+CONFIG_CGROUP_HUGETLB=y
+CONFIG_CPUSETS=y
+CONFIG_MEMCG=y
+CONFIG_MEMCG_SWAP=y
+CONFIG_BLK_CGROUP=y
+CONFIG_CGROUP_PERF=y
+CONFIG_CGROUP_BPF=y
+CONFIG_CGROUP_NET_PRIO=y
+CONFIG_CGROUP_NET_CLASSID=y
+
+# ── Namespaces — rootless Podman requires all of these ───────────────────────
+CONFIG_NAMESPACES=y
+CONFIG_UTS_NS=y
+CONFIG_TIME_NS=y
+CONFIG_IPC_NS=y
+CONFIG_USER_NS=y
+CONFIG_PID_NS=y
+CONFIG_NET_NS=y
+
+# ── Security ──────────────────────────────────────────────────────────────────
+CONFIG_SECCOMP=y
+CONFIG_SECCOMP_FILTER=y
+CONFIG_BPF_SYSCALL=y
+CONFIG_BPF_JIT=y
+
+# ── ARM64 hardware crypto (AES/SHA via CPU instructions) ─────────────────────
+CONFIG_CRYPTO_SHA256=y
+CONFIG_CRYPTO_AES=y
+CONFIG_CRYPTO_SHA2_ARM64_CE=y
+CONFIG_CRYPTO_AES_ARM64_CE=y
+CONFIG_CRYPTO_GHASH_ARM64_CE=y
+
+# ── Disable: display / audio / input (no display in -display none) ───────────
+# CONFIG_SOUND is not set
+# CONFIG_DRM is not set
+# CONFIG_FB is not set
+# CONFIG_FRAMEBUFFER_CONSOLE is not set
+# CONFIG_HID is not set
+# CONFIG_INPUT_KEYBOARD is not set
+# CONFIG_INPUT_MOUSE is not set
+
+# ── Disable: USB / wireless / Bluetooth (not present in QEMU virt) ───────────
+# CONFIG_USB_SUPPORT is not set
+# CONFIG_WIRELESS is not set
+# CONFIG_CFG80211 is not set
+# CONFIG_BT is not set
+
+# ── Disable: storage buses not used (virtio-blk only) ────────────────────────
+# CONFIG_ATA is not set
+# CONFIG_SCSI_LOWLEVEL is not set
+# CONFIG_MMC is not set
+# CONFIG_MEMSTICK is not set
+
+# ── Disable: other unused subsystems ─────────────────────────────────────────
+# CONFIG_WATCHDOG is not set
+# CONFIG_IOMMU_SUPPORT is not set
+# CONFIG_CAN is not set
+# CONFIG_NFC is not set
+# CONFIG_INFINIBAND is not set
+# CONFIG_NEW_LEDS is not set
+# CONFIG_LEDS_CLASS is not set
+# CONFIG_EDAC is not set
+# CONFIG_W1 is not set
+# CONFIG_PCCARD is not set
+# CONFIG_MTD is not set