OrionOS/iso

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