Unofficial · version-stamped · built from the source and the issue tracker

Omarchy Linux, with the answers the manual leaves out.

Does Omarchy run on your laptop? What broke in the last update? What does that error mean? Every page here says which Omarchy version it was checked against, links the thread the fix came from, and never hosts an installer. The official site is omarchy.org.

Does it run on my hardware?Component and model reports: NVIDIA, suspend, Wi‑Fi, audio, fingerprint, and the machines people actually own. What does this error mean?One page per real failure, indexed by the exact error string, fix first, with the version it applies to. Which command or key does that?All 444 commands, 228 keybindings, and the menu tree, generated per release with diffs. What changed in v4.0.4?Release notes, what each migration did to your machine, upgrade guides, and channel status.

v4.0.4Current release · 2026-09-15

2,244Open issues upstream · 1,143 opened in 30 days

46,558Discord members, where support happens (unindexed)

1,261,480ISO downloads, year one (official)

4.0 → LuaQuattro moved Hyprland config to Lua and the shell to Quickshell

Most-reported problems

Ranked by how many upstream issues mention the problem. Every page is version-stamped.

NVIDIA drivers on Omarchy 4
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.
Quickshell crashes or the Omarchy bar is missing
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.
omarchy update fails or hangs part way through
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.
Chromium flickers, plays black video, or loses hardware acceleration
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.
Laptop will not resume from suspend on Omarchy
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.
"Something went wrong during the update!" on a migration
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.
No sound from laptop speakers on Omarchy
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.
Claude Code or agent CLI not found on Omarchy
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.

All fixes →

Machines people actually run

Framework Laptop 13 on Omarchy silver
Lenovo ThinkPad X1 Carbon on Omarchy silver
ASUS Zenbook and Vivobook on Omarchy Linux silver
Lenovo ThinkPad T14 and T14s (Gen 1 to Gen 6) on Omarchy silver
Lenovo ThinkPad T480 and T480s on Omarchy silver
Lenovo Yoga on Omarchy Linux silver

Full hardware index → · Submit a report

Why this site exists

Omarchy's support happens in a Discord that search engines cannot read, and its issue tracker is for verified bugs only. Fixes get found and then lost. This site turns what people have already solved into pages you can search, with credit to the person who solved it, a link to the thread, and a badge saying which version it was checked on. Reference data is generated from the MIT-licensed source at each release, so the command list is never out of date by more than a build.

It is an independent project. Read which Omarchy sites are official, the trademark facts, and how this site is run.