Pairs with omarchy-installer's rename of bin/omarchy-setup-user to bin/omarchy-finalize-user. The orchestrator now invokes omarchy-finalize-user --force --first-install in the run_chroot_finalizer phase, and the phase-ordering docstring is updated to match.
Omarchy ISO
The Omarchy ISO is the only supported way to install Omarchy. It ships the Omarchy Configurator, installs Arch Linux, installs the Omarchy packages from the bundled mirror, runs target system setup in the chroot, creates the user, and runs omarchy-setup-user for that user.
Downloading the latest ISO
See the ISO link on omarchy.org.
Creating the ISO
Run ./bin/omarchy-iso-make; output goes into ./release.
For local development, build the ISO from sibling checkouts:
./bin/omarchy-iso-make --local-source ../omarchy-installer ../omarchy-pkgs
Despite the local folder name, the first argument is the Omarchy source checkout (runtime commands, configs, setup scripts, themes, shell, migrations). The installer itself lives in this ISO repo.
Use --dev or --rc to build against those package channels.
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 rclone configuration (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.