Public Alpha 0.5.0
Back to docs

Testing

DevelOS includes local smoke tests for validating ISO boot behavior before doing deeper install testing.

Live ISO Smoke Test

Use test-live to verify that a built ISO can boot to the live system login prompt in QEMU.

sudo make test-live ISO=output/<iso-name>.iso

If ISO is omitted, the newest ISO under output/is used.

sudo make test-live

What It Checks

The test boots the ISO with QEMU, directly loads the ISO kernel and initramfs, and waits for the serial login prompt:

develos login:

This is a boot smoke test only. It does not test graphical login, dwm, Calamares, or installation to disk.

Requirements

  • qemu-system-x86_64
  • blkid
  • mount and umount
  • Permission to loop-mount the ISO, which is why sudo is required.

Logs

Logs are written under:

output/test/
  • output/test/live.log: serial boot output from the guest.
  • output/test/live-qemu.log: QEMU stderr.
  • output/test/iso-mount: temporary mount point for reading the ISO kernel and initramfs.

Troubleshooting

If the test fails, inspect:

less output/test/live.log
less output/test/live-qemu.log

If a previous failed run leaves the ISO mount busy, the script attempts a lazy unmount automatically on the next run.