omacom /omarchy-iso

★ 299⑂ 208👁 5⑃ 384● 68▤ 0
ShellMITCreated 2025-07-27
-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 p

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON