vm-forge

​Native QEMU virtual machine launcher for Android to run ARM64 Linux VMs natively without root.

Setting up the VM files The app needs three files in place before it can boot a VM: the Debian disk image, the UEFI firmware (bundled with the app already), and a cloud-init seed for the first-boot password. The disk image + seed are prepared once (on a PC or via Termux, since they need tools not worth bundling into the app itself) and then imported into the app:

Get a Debian arm64 cloud image and build a seed ISO — either: Via Termux: run scripts/test-in-termux.sh then scripts/make-seed.sh (see "How the native binary was collected" below for background) — produces ~/vm-test/debian-13-genericcloud-arm64.qcow2 and ~/vm-test/seed.iso Or prepare equivalent files any other way Copy both files to somewhere the app's file picker can reach, e.g. /sdcard/Download/ (cp ~/vm-test/*.qcow2 ~/vm-test/seed.iso /sdcard/Download/ in Termux) In the app, tap "Import rootfs.qcow2" and "Import seed.iso", picking each file from Downloads — this copies them into the app's private storage under the exact names QEMU expects Tap "Start VM", then "Open Terminal" to watch it boot and log in (first-boot password is shown by make-seed.sh — save it, it's not shown again)