David Heinemeier HanssonandClaude Fable 5
04aafcb781
Full-disk installs flaked with "Partition(s) 1, 2 on /dev/vda have been written, but we have been unable to inform the kernel of the change": archinstall's disk wipe and parted's own partition registrations fire udev probes, and when one is still holding the disk mid-commit, the BLKPG sync fails and the install halts. The table is written correctly when this happens — only the kernel's view is stale — so settle udev before partitioning and redo the filesystem operations (wipe, partition, format) when parted throws exactly this error. Recoveries are logged so they show up in the support log. Reproduced headlessly by booting the ISO on a serial console and driving the real installer: stock failed 1 in 5 full-disk cycles at this exact phase, with an audit watch confirming nothing else writes the disk. With the fix, 13 of 13 cycles got cleanly through partitioning. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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. By default the ISO uses the Omarchy packages and tracks the quattro branch, from the stable mirror. Pass --edge to use omarchy-dev and omarchy-settings-dev from the edge mirror.
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. Both --dev and --edge select the dev packages from the edge mirror.
Testing the ISO
Run ./bin/omarchy-iso-boot [release/omarchy.iso].
To exercise installation alongside existing Windows-style partitions, run
./bin/omarchy-iso-test-windows-disk [release/omarchy.iso]. It creates a
synthetic disk in /tmp with an existing ESP and data partition plus ample
unallocated space, then offers to start an interactive installation on it. The
fixture exercises Windows partition preservation but does not contain Windows.
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 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.