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

Understand why a snapshot rollback leaves your home directory broken

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

The cause is exactly right and confirmed almost verbatim by manual/47-system-snapshots.md ('This will restore your root filesystem, but not your /home ... your ~/.config directory is kept as-is') and by default/snapper/root which sets SUBVOLUME="/". Only the file names are stale: current Omarchy uses Lua Hyprland configs, so omarchy-refresh-config hypr/bindings.conf and hypr/looknfeel.conf will not resolve. They are now hypr/bindings.lua and hypr/looknfeel.lua. Minor: the manual cp -r backup is redundant because omarchy-refresh-config already writes a timestamped .bak beside each file and deletes it again if nothing changed.

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

omarchy-refresh-config overwrites the named file with stock defaults with no prompt. Copy ~/.config/hypr aside first.

Symptom

User rolls back to a pre-update Limine snapshot to escape a broken update, but the desktop is still broken in the same way. The theme is still wrong, the top bar still misbehaves, the same keybindings are still missing.

Cause

Omarchy snapshots cover the root subvolume only. Everything under /home, including ~/.config/hypr, ~/.config/waybar, ~/.config/omarchy, is untouched by a restore. Migrations that rewrote files in ~/.config are therefore still applied after the rollback, so package state and user config are now mismatched in the opposite direction.

Fix

After rolling back the system, also reset the user-side config, which the snapshot did not touch. Note that omarchy-refresh-config already makes a timestamped .bak of anything it replaces, so an extra manual copy is optional:


omarchy-refresh-hyprland

For individual files, refresh just the one that drifted. Current Omarchy uses Lua configs, not .conf:


omarchy-refresh-config hypr/bindings.lua
omarchy-refresh-config hypr/looknfeel.lua
omarchy-refresh-config hypr/monitors.lua
omarchy-refresh-config hypr/input.lua

If you are on an older Omarchy 3 install these are still .conf (hypr/bindings.conf, hypr/looknfeel.conf). Check which you have:


ls ~/.config/hypr/

Because of this root-only split, back up your dotfiles independently of snapshots. Keep ~/.config in a git repo or use GNU stow.

Verify

diff -r ~/.config/hypr ~/.local/share/omarchy/config/hypr shows only your intentional overrides, and the desktop matches the rolled-back version.

Sources

snapshot-restore-does-not-restore-home