Appliance Installer Evidence
Run the installer in QEMU through HTTP/PXE, ISO, or Ventoy-on-FAT paths, with separate failure-path and rescue scenarios. A successful action verifies its selected path; a skipped action supplies no boot evidence.
Four native QEMU actions exercise the installer end to end: the PXE/HTTP chain boots the installer kernel and initrd, serves the image over HTTP, and asserts serial success markers before rebooting into the written disk and logging in over SSH. The ISO path wraps the same image in a bootable ISO and also verifies GPT layout and power-off-not-reboot behaviour. The Ventoy path proves the installer finds the appliance ISO as a file on a FAT/exFAT data partition rather than as burned boot media. The scenarios action covers what the other three do not: a forced mid-init panic recovering cleanly, MAC-based install pinning on multi-homed boxes, and rescue console access.
Until a release publishes an appliance image, build
one with the appliance guide.
The current amd64 installation ISO is under 150 MB.
The prod build with the hardware kernel
profile on October 1, 2026 produced
ze-20261001-142644.iso: 128,933,888 bytes
(128.93 MB) for the complete ISO.
From the source checkout, prepare the build-host
command with ./le build host-driver,
then use ./ze-host appliance kernel
to build the installer kernel. Set
ZE_INSTALL_KERNEL to its printed path
for these QEMU tests. The appliance guide covers
the image and native-architecture build prerequisites.
# HTTP/PXE install chain $ ./le test qemu installer # bootable ISO chain $ ./le test qemu installer-iso # Ventoy ISO-on-FAT path $ ./le test qemu installer-ventoy # fault/pin/rescue scenarios $ ./le test qemu installer-scenarios
QEMU and an operator-supplied installer kernel
(ZE_INSTALL_KERNEL=/path/to/vmlinuz);
each native QEMU action reports a clear skip when
none is usable.