Fixes
Paste your error into the search box, or browse by area. Every page says which Omarchy versions it applies to and who found the fix. Built against 5,202 upstream issues and 2,144 discussions.
Updates and package errors
- "Something went wrong during the update!" on a migration workaround 3.x
An Omarchy migration failed and aborted the update. How to find the failing migration id, re-run omarchy-migrate safely, and skip one when it will never pass. - Creating a snapshot failed. workaround 3.x
Creating a snapshot failed during omarchy update. Fix the snapper error: an active swapfile on root, /.snapshots not a subvolume, or a missing snapper config. - error: failed to commit transaction (failed to retrieve some files) workaround 3.x
Pacman 404s from stable-mirror.omarchy.org usually mean stale package databases, not a broken mirror. Refresh with pacman -Syy, then run omarchy update. - Errors occurred, no packages were upgraded. workaround 3.x
Why pacman aborts an Omarchy update with "failed to commit transaction" and nothing upgraded, and the order to try mirror, keyring and file-conflict fixes. - omarchy update fails or hangs part way through workaround 4.0.0 and later
Read the omarchy update log, find the stage that died, rerun safely, replay a failed migration, and decide when to roll back on Omarchy 4.0.x. - pacnew and pacsave files after an Omarchy update workaround 4.0.0 and later
What .pacnew and .pacsave files mean after an Omarchy update, which ones matter on Omarchy 4, and how to merge them without breaking pacman or your boot. - signature from "..." is unknown trust workaround 3.x
Pacman aborts an Omarchy update with a signature is unknown trust error. Refresh archlinux-keyring, trust the Omarchy signing key, then retry the update.
Boot, login, and disk encryption
- Kernel panic after an Omarchy update (Limine boot menu) workaround 3.x
Kernel panic or a dead boot after an Omarchy update: pick another kernel in the Limine menu, undo the 4.0.4 linux-omarchy default, or roll back a snapshot. - LUKS passphrase not accepted at boot workaround 3.x
The Omarchy disk unlock prompt rejects the right LUKS passphrase. Type it as US QWERTY to get in, then put XKBLAYOUT in vconsole.conf and rebuild the UKI. - SDDM login loop or password not accepted on Omarchy workaround 3.x
SDDM login loop on Omarchy: the greeter always types US, so non-US passwords fail. Fix the greeter keymap, faillock, the autologin user, and a dying session. - Stuck at a TTY, or cannot switch to a TTY on Omarchy info 4.0.0 and later
Stuck at a text console on Omarchy 4, or Ctrl+Alt+F keys do nothing: which VT to use, how to read the uwsm session log, and how to start Hyprland by hand. - You are in emergency mode after an Omarchy update workaround 3.x
Omarchy drops to emergency mode after an update. Boot a Limine snapshot, then repair the kernel cmdline, the LUKS selector, or the failed fstab mount.
Shell, bar, menu, and keybindings (Quickshell)
- attempt to index a nil value (global 'o') workaround 3.x
Hyprland starts with no bindings, no monitors and a config-error banner after Quattro. Your hyprland.lua never loads Omarchy's helpers, so the global o is nil. - Clipboard history not working on Omarchy 4 workaround 4.0.0 and later
Omarchy 4 clipboard history stops recording text when a capture.sh process wedges. Kill it to get capture back, and fix Super + V paste failures. - Custom keybindings stopped working after upgrading to Omarchy 4 workaround 4.0.0 and later
Omarchy 4 Quattro stopped loading ~/.config/hypr/bindings.conf. Port your custom keybindings to bindings.lua with o.bind and hl.unbind, then reload Hyprland. - Fonts wrong or missing after an Omarchy update workaround 4.0.0 and later
Wrong monospace font, tofu boxes, or broken emoji after an Omarchy 4 update. Reset fontconfig with omarchy font set, rebuild the font cache, fix leftovers. - GTK4 and libadwaita apps ignore the Omarchy theme workaround 3.x
Nautilus and other GTK4/libadwaita apps stay Adwaita gray on Omarchy 4. Omarchy only sets light or dark, so generate a gtk.css palette with a template and hook. - Notifications not showing workaround 4.0.0 and later
No notification toasts on Omarchy 4? Check do-not-disturb, find out which daemon owns org.freedesktop.Notifications, and test with notify-send. - Omarchy lock screen will not unlock workaround 3.x
Omarchy lock screen rejects the right password or never shows a prompt. Reset the faillock counter, restart the shell from a TTY, and repair the lock PAM file. - Omarchy shell plugin fails to load or the bar disappears workaround 4.0.0 and later
A third-party or cloned Omarchy shell plugin will not load, or installing one leaves no bar at all. How to find the failing plugin, validate it, and remove it. - Quickshell crashes or the Omarchy bar is missing workaround 4.0.0 and later
The Omarchy 4 Quickshell bar vanished or omarchy-shell keeps crashing. Restart the shell, read its journal, reset a broken bar, fix a Qt ABI mismatch. - Screenshot shortcut not working workaround 3.x
Print Screen does nothing, the picker never appears, or screen recording fails silently on Omarchy 4.x. How to find which part of the capture chain broke. - Walker launcher missing after update by-design 4.0.0 and later
Omarchy 4 removed the Walker launcher. Super + Space now opens the Omarchy menu and Super + Alt + Space opens the apps-only launcher. - Where did Waybar go after the Omarchy 4 update? by-design 4.0.0 and later
Omarchy 4 replaced Waybar with the Quickshell bar, so waybar, its config, and omarchy-refresh-waybar are all gone. Here is where each piece moved to.
Display, GPU, and scaling
- Apps blurry or huge with fractional scaling on Omarchy workaround 3.x
Fractional scaling on Omarchy 4 leaves GTK, Electron and XWayland apps oversized or soft. Fix the monitor scale, GDK_SCALE, text scaling and per-app flags. - Black screen after login on Omarchy workaround 4.0.0 and later
Black screen after login on Omarchy 4: tell a dead Hyprland apart from a dead Quickshell, get a TTY, and fix the GPU, uwsm env, and VM causes. - Cursor invisible, wrong size, or a black box on Omarchy workaround 3.x
Mouse pointer missing, tiny, huge, or drawn as a black square on Omarchy 4. Force software cursors in looknfeel.lua and set the size where Hyprland reads it. - Hybrid GPU laptop black screen or login loop (AQ_DRM_DEVICES) workaround 3.x
Hybrid NVIDIA plus Intel or AMD laptops on Omarchy 4: why a by-path AQ_DRM_DEVICES value login-loops Hyprland, and the colon-free fix that works. - Monitor layout lost after Quattro: monitors.conf replaced by monitors.lua open 4.0.0 and later
After the Omarchy 4 Quattro upgrade your monitors.conf is ignored and monitors.lua holds stock defaults. Port each monitor line to hl.monitor by hand. - Multi-monitor layout not saved: scale and position reset on Omarchy 4 workaround 4.0.0 and later
Your external monitor layout, scale and position do not survive a reload on Omarchy 4. Write explicit hl.monitor rules in monitors.lua, then reload. - NVIDIA drivers on Omarchy 4 workaround 4.0.0 and later
How Omarchy 4 detects your NVIDIA GPU, which driver package it installs, the env vars it sets, and the fix order when the NVIDIA driver breaks.
Wi-Fi, Bluetooth, and networking
- Bluetooth stops working after suspend on Omarchy workaround 4.0.0 and later
Bluetooth dead, stuck on Turned Off, or paired mice not reconnecting after resume on Omarchy 4. The shell restart, the bluez restart, and the firmware cases. - Tailscale not connecting or DNS broken on Omarchy workaround 4.0.0 and later
Tailscale says Connected while every DNS lookup fails, or the bar panel says Disconnected on a healthy tailnet. The accept-routes fix, the panel bugs, and ufw. - Wi-Fi gone or dropping after a kernel update (iwlwifi, mt7921, brcmfmac) workaround 3.x
Wi-Fi disappears or drops after an Omarchy kernel update: boot the previous Limine kernel entry, install matching headers, rebuild DKMS modules, fix firmware.
Audio
- No sound from laptop speakers on Omarchy workaround 3.x
Silent built-in speakers on Omarchy 4: restart PipeWire, install sof-firmware, drop the ASUS soft-mixer config, and read the CS35L56 amp firmware log.
Keyboard, touchpad, fingerprint, webcam
- Fingerprint enrollment fails: Enrollment failed. Please try again. workaround 3.x
Fingerprint enrollment failing on Omarchy 4 with NoSuchDevice or a generic retry message. How to tell a bad scan from a reader libfprint cannot drive. - Webcam not detected on Omarchy workaround 3.x
Why the built-in webcam is missing on Omarchy 4, split by platform: Intel IPU7 on Panther Lake, Lunar Lake, IPU6 laptops, ThinkPad IMX471, and Macs.
Apps
- 1Password not opening or scaled wrong on Omarchy workaround 4.0.0 and later
1Password oversized, its unlock or SSH approval dialog clipped, or the window nowhere to be seen on Omarchy 4. Launch it via Omarchy, reset text size. - Chromium flickers, plays black video, or loses hardware acceleration workaround 3.x
Chromium flicker, black video, or lost hardware acceleration on Omarchy 4.x hybrid laptops: point LIBVA_DRIVER_NAME at the GPU that drives your screen. - command not found: elephant by-design 3.x
Omarchy 4 removed Walker and its elephant backend, so "command not found: elephant" means a stale script or a half-finished Quattro upgrade. - command not found: xdg-terminal-exec workaround 3.x
Super+Return does nothing and menu entries fail with command not found: xdg-terminal-exec. Reinstall the package, then finish the interrupted Omarchy update. - mise: command not found, or a mise wrapper that hangs or prints noise workaround 3.x
Omarchy 4 runs Claude, Codex and gh through mise stubs in ~/.local/bin. Fix a missing mise command, a looping wrapper, and mise Python breaking AUR. - permission denied while trying to connect to the docker API by-design 4.0.1 and later
Omarchy 4.0.1 stopped putting your user in the docker group, so plain docker commands now need sudo. How to opt back in, and what the Podman proposal changes. - Printer not found on Omarchy workaround 4.0.2 and later
Your printer no longer appears by itself on Omarchy 4.0.2 and later. Add it by hand in Print Settings, or with lpadmin, and pick the right CUPS driver. - Voxtype dictation not working on Omarchy workaround 3.x
F9 and Super + Ctrl + X do nothing, Voxtype crashes, or the model never loads. The install check, the CPU baseline, the GPU symlink, and the mic.
AI agents and dev tools
- Claude Code or agent CLI not found on Omarchy workaround 4.0.0 and later
Why claude, codex, gh and other mise-backed agent CLIs go missing, hang forever, or print junk on Omarchy 4, and how to rebuild the stubs and fix PATH. - error: invalid value 'untrusted' for '--ask-for-approval' fixed 4.0.0 – 4.0.1
Codex limits stay empty in the Omarchy agents panel because the collector passes an --ask-for-approval value Codex CLI removed. Fixed in 4.0.2.
Gaming
- Steam or Proton game crashes on launch workaround 3.x
Steam and Proton games that die seconds after launch on Omarchy 4: the lib32 driver check, leftover SDL_VIDEODRIVER, and the gamescope launch option.
Installing
- Omarchy installer fails or stalls partway through workaround 4.0.0 and later
Read /var/log/omarchy-install.log on the live ISO and find the first error. Offline mirror, ESP mount and psmouse failures each have a different fix. - Secure Boot Violation, or the Omarchy USB will not boot workaround 3.x
Secure Boot Violation and UEFI boot failures on Omarchy: turn Secure Boot off, pick the UEFI USB entry, fix Ventoy, and re-sign Limine after an update.
Other
- Battery drains fast on Omarchy workaround 3.x
Why an Omarchy laptop burns battery faster than Windows, what power management actually ships in 4.0.4, and the profile, screensaver, and hybrid GPU fixes. - Hibernate fails or hangs on Omarchy workaround 3.x
Hibernate writes the image but never resumes, or hangs before power-off. Check the Btrfs swapfile offset, NVIDIA early KMS, and HibernateMode on Omarchy 4. - Laptop will not resume from suspend on Omarchy workaround 3.x
Omarchy 4 laptop stuck black after suspend: tell a failed freeze from a kernel resume failure, then fix FUSE mounts, NVIDIA sleep services and kernel bugs.
Reported errors without a page yet
The most-reported topics upstream that we have not written up. Each link runs a GitHub search across the Omarchy issues so you can find the thread.
Questions people ask
- Where do Omarchy users get support?
- Officially in the Omacom Discord (#omarchy-help) and GitHub Discussions; GitHub issues are for verified bugs only. Those places are hard to search, so this site rewrites solved problems as one page per error, with credit and links back to the thread.
- How do I find the error string?
- Copy the exact text from the terminal, the update log, or the notification. On Omarchy 4 the update log lives under ~/.local/state/omarchy/ and omarchy update prints where it wrote it. Paste the string into the search box.
- What if my error is not here?
- Check the "reported errors without a page yet" list below: each links a GitHub search that finds the upstream threads. Then run omarchy debug and ask in the official Discord. If you solve it, tell us and it becomes a page.