The safest workflow is to test in a VM before trying real hardware.
- Build an ISO (see docs/BUILD.md).
- Create a VM (virt-manager/QEMU) with:
- UEFI firmware if possible
- A disposable virtual disk (the installer wipes it)
- Boot the ISO.
- In the live environment, run:
sudo cvh-install
- Complete an install and reboot into the installed system.
- ISO boots (UEFI and/or BIOS)
- Installer completes without errors
- Installed system boots
- Wayland session starts (niri or Hyprland)
- Network works (basic connectivity)
If a test fails, include logs in your issue:
journalctl -b- Any installer output shown on screen