Current archiso package does not install initcpio hook files (confirmed: find /usr -path */initcpio/hooks/archiso returns nothing). Write the hook and its mkinitcpio install script directly into the profile airootfs so COPY carries them into the image without any package dependency. Hook finds ISO by archisosearchuuid= kernel param, waits up to 30s for the device to appear via blkid, mounts iso9660→squashfs→overlay onto /new_root. mkinitcpio detects /new_root is already mounted and succeeds. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
OrionOS ISO Builder
Two build paths are provided. Pick the one that matches your host.
Path A — Arch Linux host (native, recommended)
Requires archiso and pacman-contrib.
sudo pacman -S archiso
sudo make iso # runs iso/build-arch.sh
Path B — Debian / Ubuntu host
Requires xorriso, squashfs-tools, debootstrap, grub-pc-bin, grub-efi-amd64-bin.
sudo apt-get install -y xorriso squashfs-tools debootstrap \
grub-pc-bin grub-efi-amd64-bin mtools
sudo bash iso/build.sh
Output lands in iso/output/OrionOS-YYYYMMDD.iso.
Path C — Docker (any host with Docker)
make iso
The Dockerfile (iso/docker/Dockerfile) builds inside archlinux:latest,
compiles OrionOS, and runs mkarchiso. Output is written to iso/output/.
Writing the ISO to a USB drive
# Find your USB device (e.g. /dev/sdb) — be careful
lsblk
sudo dd if=iso/output/OrionOS-*.iso of=/dev/sdX bs=4M status=progress oflag=sync
Or use Ventoy — just copy the .iso onto the Ventoy USB.
First boot
- Logs in automatically as root on tty1 and starts X / OrionOS.
- Super+F1 or bottom-left hot corner → launcher
- Super+V → clipboard manager
- Print → screenshot (Shift+Print → region)
- Top-left hot corner → Exposé overview