David Heinemeier HanssonandClaude Fable 5
168c6edb0b
Ported from omarchy-4 (764a65f), including that branch's follow-up switch from GTK to SDL: GTK's GL display path crops the guest framebuffer on HiDPI Wayland desktops (434db24). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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 with --local-source, from the dev branch with --dev, or from the quattro branch with --quattro. The dev and quattro builds use the edge package mirror.
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 [release/omarchy.iso]. The signing key is retrieved from the shared Omarchy vault with the 1Password CLI.
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.