Files
OrionOS/iso
nmemmertandClaude Sonnet 4.6 ebb61beaac Copy archiso initcpio hooks directly into airootfs at build time
The hook package install inside the pacstrap chroot may silently skip
the initcpio install step under QEMU emulation, leaving the archiso hook
absent from the initrd (confirmed: no 'running late hook [archiso]' in
boot output despite UUID match on device).

Explicitly copy /usr/lib/initcpio/hooks/archiso and install/archiso from
the build host into the airootfs before mkarchiso runs mkinitcpio, so
the hook is present regardless of how the chroot package install behaves.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-08-31 10:52:05 -04:00
..

OrionOS ISO Builder

Two build paths are provided. Pick the one that matches your host.

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