-1
Daily
299
stars
208
forks
5
watchers
384
prs
68
issues
0
releases
README
Omarchy ISO
The Omarchy ISO is the only supported way to install Omarchy. It ships the Omarchy Configurator, writes a pre-built Arch Linux + Omarchy root image (a zstd-compressed btrfs partition image) onto the target with zstdcat | dd, gives it a fresh filesystem id and grows it to the partition, installs the per-machine packages (audio firmware, and a kernel the image lacks) from the bundled mirror, runs target system setup in the chroot, creates the user, and runs omarchy-provision-user for that user.
Get Omarchy
1. Download the ISO.
2. Write it to a USB stick. Use balenaEtcher on Mac or Windows, or caligula on Linux.
3. Turn off Secure Boot and/or TPM in the BIOS.
4. Boot from the stick.
5. Answer the configuration questions and select a drive.
The install takes under a minute on the fastest machines and up to 5 minutes on an older computer.
Verify the download
Verify the ISO before you write it to the stick. Otherwise, a corrupted download causes a pacman "invalid or corrupted package" error several minutes into the install.
Every release ISO has a .sha256 file and a .sig file next to it. Run these commands to download and verify the ISO of the latest release of omacom/omarchy:
bash
version=$(curl -fsSL https://api.github.com/repos/omacom/omarchy/releases/latest | jq -r .tag_name)
version=${versionv}
iso=omarchy-$version-x86.iso
curl -fLO "https://iso.omarchy.org/$iso"
curl -fsSLO "https://iso.omarchy.org/$iso.sha256"
sha256sum -c "$iso.sha256"
The checksum only catches a corrupted download. The .sig file proves that Omarchy built the ISO. Fetch the Omarchy signing key by its full fingerprint, then verify the ISO with GnuPG:
bash
gpg --keyserver hkps://keys.openpgp.org --recv-keys 40DFB630FF42BCFFB047046CF0134EE680CAC571
curl -fsSLO "https://iso.omarchy.org/$iso.sig"
gpg --verify "$iso.sig" "$iso"
The output must say Good signature from "Omarchy " and show the key 40DFB630FF42BCFFB047046CF0134EE680CAC571. A warning that the key is not certified with a trusted signature is expected. It means only that you have not signed the key yourself.
More in the manual
- Getting started: the install step by step, installing for another owner, and installing without encryption.
- Dual-boot install: install Omarchy in the free space of a drive, beside Windows or another OS.
- Unattended installs: let the ISO install itself from a configuration on a second drive, with no keyboard and no wizard.
For maintainers
The rest of this file covers building, testing and publishing the ISO.
What is published, and where
| What | Where | When |
| --- | --- | --- |
| Release ISO | https://iso.omarchy.org/omarchy--x86.iso and -aarch64.iso (before 4.5.0: omarchy-.iso) | Each release |
| Edge ISO | https://nightly.omarchy.org/edge//omarchy-edge-.iso | Every night |
| VM image of edge | https://nightly.omarchy.org/edge//omarchy-edge-.qcow2 | Every night |
| VM image of the latest release | https://nightly.omarchy.org/stable///omarchy-.qcow2 | Once pTop issues
#151Overview over install speed improvements7 comments · 2026-09-03#150Build and publish omarchy's `.wsl` artifact4 comments · 2026-09-03#289Installer ISO is rejected by firmware with Secure Boot on; is a shim-signed path planned?2 comments · 2026-10-18#430Transient page-cache corruption fails root-image verify; re-read cold before calling the medium corrupt1 comments · 2026-11-11#303Recover from misread packages by refetching online, and optionally offer a netinstall ISO1 comments · 2026-10-20#201Show the install step while the progress bar is still empty1 comments · 2026-09-27#124Staged idle on Omarchy: both monitors physically OFF until real activity + USB keyboard power-cut (with 2 upstream findings)1 comments · 2026-08-25#451Windows Dev Kit 2023 (sc8280xp-blackrock): live ISO has no USB in the initramfs and loses the display at ~30 s0 comments · 2026-11-15