Unofficial community reference. Not affiliated with 37signals or the Omacom Foundation. Download Omarchy only from omarchy.org.
omarchylinux.org Unofficial field manual

Upgrades

What an Omarchy upgrade does to your machine and what to do before and after.

Before you run omarchy update: a pre-flight checklist

A pre-flight checklist for omarchy update on Omarchy 4.0.4: check your channel, free space, snapshots and pending migrations, then handle pacnew files yourself.

info 4.0.0 and later

Docker to Podman on Omarchy: what shipped and what has not

Omarchy 4.0.1 made the docker group opt-in. Podman is still an unmerged branch. What is shipped, what is pending, and how to prepare now.

info 4.0.1 and later

Roll back a bad Omarchy update with snapper and Limine

How to roll back a bad Omarchy update using Btrfs snapshots, snapper and the Limine boot menu, plus what a snapshot restore does not cover.

info 4.0.0 and later

Upgrading Omarchy 3.x to 4 (Quattro)

What the Omarchy 3.x to 4 Quattro upgrade changes, what omarchy-upgrade-to-quattro actually does, and which of your configs silently stop loading.

workaround 3.x – 4.0.4

What Omarchy migrations do and how to read them

Omarchy migrations are one-time repair scripts in migrations/*.sh. How omarchy-migrate runs them, how to preview them, and what to do when one aborts an update.

info 4.0.0 and later