Ryan Hughes
89cc55d559
The orchestrator drives an offline install on the live ISO using
archinstall as a library subsystem. Lands under configs/airootfs/ so
mkarchiso bakes it into the live squashfs directly:
/usr/share/omarchy-iso/orchestrator/ (the Python package)
/usr/local/bin/omarchy-iso-install (thin shell wrapper that
execs python -m orchestrator.main)
Two corrections vs the previous omarchy-installer location:
1. omarchy-installer dropped from EARLY_PACKAGES \u2014 it's live-ISO-only
install tooling, must never land on the target. /etc/skel is still
populated pre-useradd via omarchy-settings.
2. run_chroot_finalizer now copies /usr/share/omarchy from the live
ISO into /mnt/tmp/omarchy-install/ before arch-chroot. finalize.sh
+ install/ scripts run from /tmp inside the chroot; /tmp is wiped
on first reboot, so the target boots with zero install detritus.
Omarchy ISO
The Omarchy ISO streamlines the installation of Omarchy. It includes the Omarchy Configurator as a front-end to archinstall and automatically launches the Omarchy Installer after base arch has been setup.
Downloading the latest ISO
See the ISO link on omarchy.org.
Creating the ISO
Run ./bin/omarchy-iso-make and the output goes into ./release. You can build from your local $OMARCHY_PATH for testing by using --local-source or from a checkout of the dev branch (instead of master) by using --dev.
Environment Variables
You can customize the repositories used during the build process by passing in variables:
OMARCHY_INSTALLER_REPO- GitHub repository for the installer (default:basecamp/omarchy)OMARCHY_INSTALLER_REF- Git ref (branch/tag) for the installer (default:master)
Example usage:
OMARCHY_INSTALLER_REPO="myuser/omarchy-fork" OMARCHY_INSTALLER_REF="some-feature" ./bin/omarchy-iso-make
Testing the ISO
Run ./bin/omarchy-iso-boot [release/omarchy.iso].
Signing the ISO
Run ./bin/omarchy-iso-sign [gpg-user] [release/omarchy.iso].
Uploading the ISO
Run ./bin/omarchy-iso-upload [release/omarchy.iso]. This requires you've configured rclone (use rclone config).
Full release of the ISO
Run ./bin/omarchy-iso-release VERSION to create, test, sign, and upload the ISO in one flow. Add --rc to release an RC build instead.