Update or upgrade an Omarchy 3 install after the master branch disappeared
Checked live on 2026-10-05. gh api repos/omacom/omarchy/branches/master resolves to quattro. https://omarchy.org/install still serves eval "$(curl -fsSL https://raw.githubusercontent.com/basecamp/omarchy/refs/heads/master/boot.sh)", and that URL returns 404. The rc branch exists and carries bin/omarchy-update-git (runs git -C $OMARCHY_PATH pull --autostash), bin/omarchy-upgrade-to-quattro, version 3.8.5, and an omarchy-menu Update entry Omarchy To Quattro that runs omarchy-upgrade-to-quattro. The upgrade script prints Upgrade incomplete - do NOT reboot. and rewrites /etc/pacman.conf and the Snapper policy, which matches the danger. rc's boot.sh clones with git clone --branch and no --single-branch or depth, so git fetch origin gets rc and git switch rc creates the tracking branch. The rc-mirror failure in the fix is a reporter's account from #12436 and is worded as one. The workaround commands match the #12436 comment verbatim.
The Quattro upgrade is one-way and multi-stage. It replaces the pacman configuration and the Snapper retention policy. Take a snapshot and a backup of anything important first.
Symptom
On Omarchy 3 (git checkout at ~/.local/share/omarchy), omarchy-update fails at the Update Omarchy git step, typically with git saying Your configuration specifies to merge with the ref 'refs/heads/master' from the remote, but no such ref was fetched. The documented path to Omarchy 4 (update first, then Omarchy To Quattro) is blocked by it. The manual install command from an existing Arch system also fails:
curl -fsSL https://omarchy.org/install | bash
curl: (22) The requested URL returned error: 404
Cause
Upstream's master branch, which Omarchy 3 checkouts track, was removed around 2026-09-14. The GitHub API now resolves branches/master to quattro, and raw URLs under refs/heads/master return 404. Omarchy 3's bin/omarchy-update-git runs git -C $OMARCHY_PATH pull --autostash against the tracked branch, which no longer exists. https://omarchy.org/install still serves eval "$(curl -fsSL https://raw.githubusercontent.com/basecamp/omarchy/refs/heads/master/boot.sh)", and that URL returns 404 (checked 2026-10-04). The rc branch still exists and carries both bin/omarchy-update-git and bin/omarchy-upgrade-to-quattro.
Fix
Omarchy 3 install: point the checkout at rc, update, then upgrade to Quattro:
cd ~/.local/share/omarchy
git fetch origin
git switch rc
omarchy-update
omarchy-upgrade-to-quattro
The last step is also in the Omarchy 3 menu under Update > Omarchy To Quattro. Read the Quattro upgrade records before starting it: back up /etc/snapper/configs/root, and do not reboot if it prints Upgrade incomplete - do NOT reboot.
New install: use the Omarchy ISO. The curl installer from an existing Arch system is broken. A reporter's attempt with OMARCHY_REF=rc and the rc boot.sh failed at the rc mirror, and it installs Omarchy 3 that then needs the Quattro upgrade anyway.
Verify
git -C ~/.local/share/omarchy rev-parse --abbrev-ref --symbolic-full-name '@{upstream}' prints origin/rc, omarchy-update completes, and after the upgrade pacman -Q omarchy reports a 4.x package.