Files
OrionOS/iso
nmemmertandClaude Sonnet 4.6 ca0e9f7c72 Bundle archiso initcpio hook directly in repo
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>
2026-08-31 11:34:08 -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