OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
pacman-aur medium common DISPUTE

Downgrade a package that an update broke

archomarchyendeavouroscachyosmanjaronvidiaamdinteldesktoplaptop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

Checked the Arch wiki Downgrading packages and Arch Linux Archive pages (raw wikitext, retrieved 2026-09-06), the live archive layout, the downgrade(8) man page source, and this Omarchy 4 workstation. What held: the cache path and pacman -U file:///var/cache/pacman/pkg/... match the wiki, the archive layout is packages/<first letter>/<name>/ (confirmed by listing https://archive.archlinux.org/packages/x/xz/, which holds versioned .pkg.tar.zst files with detached .sig files), pacman fetching the .sig for a remote -U is what the wiki says, IgnorePkg = foo under [options] is the wiki's syntax, and the wiki's Automation section still recommends the AUR downgrade package, whose --ignore option defaults to prompting to add the package to IgnorePkg. pacman -U carries neither -S nor -u, so the Omarchy ALPM guard (/usr/bin/omarchy-update-pacman-guard, read on this machine) does not block it. What was wrong for Omarchy 4: (1) sudo mkinitcpio -P hits the /usr/local/bin/mkinitcpio wrapper installed by limine-mkinitcpio-hook, which warns that it does not update Limine entries and prompts to run limine-mkinitcpio, and it is redundant anyway because /etc/pacman.d/hooks/90-mkinitcpio-install.hook fires on usr/lib/modules/*/pkgbase and rebuilds the UKI, so the Omarchy branch now says to let the hook run or use sudo limine-update. (2) Nothing snapshots before a manual pacman -U on Omarchy 4: there is no snap-pac, and the only snapshot call is omarchy-snapshot create inside omarchy-update, so the fix now says to run it first. (3) The [omarchy] repo is not in the Arch Linux Archive and keeps only the current and previous package file (HEAD on pkgs.omarchy.org returned 200 for omarchy-4.0.2-1 and 4.0.1-1, 404 for 4.0.0-1), so downgrading one of its 30 installed packages here works only from the local cache. (4) Omarchy 4 installs nvidia-open-dkms (install/hardware/nvidia.sh, and installed here with dkms 3.4.3-2 and its 70-dkms-*.hook files), so the kernel danger text was overstated for Omarchy and understated the headers requirement, and the danger now says both. Not exercised: no package was downgraded on this machine, and the downgrade script was not run. Post-merge correction 2026-09-07 by the corpus lint: the rewritten text said sudo omarchy-snapshot create, but /usr/share/omarchy/bin/omarchy-snapshot calls sudo itself and reads OMARCHY_PATH, which sudo strips, so it is run as the user.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.
RISK

Downgrading a package whose dependencies moved forward creates a partial upgrade. If a soname changed you must downgrade or rebuild the dependants too. Leaving a package in IgnorePkg long-term guarantees eventual breakage. On Omarchy 4 the [omarchy] repo is built against current Arch, so downgrading a library those packages link to can break them, and the archive holds no older [omarchy] packages to fall back to. Downgrading the kernel without the matching linux-headers leaves DKMS modules (Omarchy's nvidia-open-dkms) unbuilt, and downgrading it without matching prebuilt modules (nvidia, virtualbox-host-modules-arch on plain Arch) leaves you with no graphics. On Omarchy the UKI is regenerated by the pacman hook, and running mkinitcpio -P by hand does not update the Limine boot entries.

Symptom

An update breaks something (the browser won't start, audio dies, a driver regresses) and you want the previous version back. pacman -S foo only ever installs the newest one.

Cause

pacman has no built-in rollback. Older versions live either in your local cache or in the Arch Linux Archive.

Fix

**On Omarchy 4, snapshot first.** A manual pacman -U gets no automatic snapshot (only omarchy update takes one), and a Snapper snapshot is the way back if the downgrade makes things worse:


omarchy-snapshot create

**From the local cache (fastest, if you have not cleaned it):**


ls /var/cache/pacman/pkg/ | grep '^foo-'
sudo pacman -U file:///var/cache/pacman/pkg/foo-1.2.3-1-x86_64.pkg.tar.zst

pacman -U carries neither -S nor -u, so the Omarchy update guard lets it through without any environment variable.

**From the Arch Linux Archive** (pacman fetches the .sig and verifies it automatically):


sudo pacman -U https://archive.archlinux.org/packages/f/foo/foo-1.2.3-1-x86_64.pkg.tar.zst

Browse available versions at https://archive.archlinux.org/packages/f/foo/ (first letter of the package name, then the package name).

**Packages from the [omarchy] repo** (pacman -Si foo | grep Repository says omarchy: for example omarchy, omarchy-settings, limine-snapper-sync, yay) are not in the Arch Linux Archive, and https://pkgs.omarchy.org/stable/x86_64/ keeps only the current and the previous package file. Use the local cache for those.

**Pin it** so the next upgrade does not immediately re-upgrade it. In /etc/pacman.conf under [options]:


IgnorePkg = foo

Remove that line once upstream fixes the bug.

**Kernel specifically.** Downgrade linux and linux-headers together, plus any prebuilt out-of-tree modules:


sudo pacman -U file:///var/cache/pacman/pkg/linux-6.16.1.arch1-1-x86_64.pkg.tar.zst \
               file:///var/cache/pacman/pkg/linux-headers-6.16.1.arch1-1-x86_64.pkg.tar.zst
  • Omarchy 4: the pacman hook 90-mkinitcpio-install.hook from limine-mkinitcpio-hook rebuilds the UKI (/boot/EFI/Linux/omarchy_linux.efi) and the Limine entries in the same transaction. Do not run mkinitcpio -P by hand: on Omarchy /usr/local/bin/mkinitcpio is a wrapper that warns it does not update Limine entries. If you need to regenerate manually, use sudo limine-update. Omarchy's NVIDIA driver is nvidia-open-dkms, which rebuilds against the downgraded kernel through the dkms hooks as long as the matching linux-headers was installed in the same transaction.
  • Plain Arch: the mkinitcpio pacman hook regenerates the initramfs. Run sudo mkinitcpio -P only if you use no hook. A prebuilt nvidia package must be downgraded to the version built for that kernel.

**Automation:** the downgrade AUR package wraps both sources and offers to add the package to IgnorePkg when it finishes:


yay -S downgrade
sudo downgrade foo

Verify

pacman -Qi foo | grep Version shows the old version and the broken behaviour is gone. For a kernel downgrade, reboot and check uname -r.

Sources

downgrade-a-broken-package