# Build A QEMU Bundle Use this guide when you need a portable local artifact for the current QEMU AArch64 prototype. ## Build ```bash ct run image-bundle ``` The output is: ```text build/artifacts/den-qemu-aarch64.tar.zst ``` ## Verify ```bash ct run image-bundle-smoke ``` This extracts the bundle into `build/image-bundle-smoke`, verifies checksums, and boots from the extracted files. ## Boot Manually Extract the bundle: ```bash tar -xf build/artifacts/den-qemu-aarch64.tar.zst -C /tmp cd /tmp/den-qemu-aarch64 ``` Boot normally: ```bash ./boot-qemu.sh ``` Run the deterministic smoke: ```bash ./boot-qemu.sh --smoke ``` Use a different QEMU binary: ```bash ./boot-qemu.sh --qemu /path/to/qemu-system-aarch64 ``` Use more memory: ```bash ./boot-qemu.sh --memory 4096 ``` Append extra kernel command-line text: ```bash ./boot-qemu.sh --append "systemd.log_level=debug" ``` ## Bundle Contents ```text Image rootfs.cpio.gz den-rootfs.ext4 boot-qemu.sh manifest.toml SHA256SUMS receipt.json den-rootfs.ext4.receipt.json ``` `receipt.json` is an in-toto Statement receipt. It can be checked with: ```bash den verify qemu-bundle --target qemu-aarch64 ``` The bundle is a prototype artifact for local boot and smoke testing. It is not yet a signed release image or installer. For Docker/OCI and UEFI disk image forms, see [Build OCI And UEFI Images](build-oci-and-uefi-images.md).