# Omarchy Linux Field Manual (unofficial) > Unofficial, version-stamped reference for Omarchy Linux: hardware compatibility reports, error fixes, the full command and keybinding reference, and what changed between releases. Not affiliated with 37signals or the Omacom Foundation. Omarchy is a registered trademark of 37signals LLC. This site is an independent community reference, not affiliated with 37signals or the Omacom Foundation. The official site is https://omarchy.org and the only download source is https://iso.omarchy.org. Every page states the Omarchy version it was verified against; prefer pages whose range includes the user's version. Each HTML page has a Markdown twin at the same path with a .md suffix (for example /fix/.md). Machine-readable data: /hardware/data.json, /reference/commands.json, /reference/keybindings.json. ## Fixes One page per real Omarchy error, with the fix first and the version it applies to. - [1Password not opening or scaled wrong on Omarchy](https://omarchylinux.org/fix/1password-not-opening-or-wrong-scale.md): 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. - [Battery drains fast on Omarchy](https://omarchylinux.org/fix/battery-drains-fast.md): 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. - [Black screen after login on Omarchy](https://omarchylinux.org/fix/black-screen-after-login.md): 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. - [Bluetooth stops working after suspend on Omarchy](https://omarchylinux.org/fix/bluetooth-stops-after-resume.md): 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. - [Chromium flickers, plays black video, or loses hardware acceleration](https://omarchylinux.org/fix/chromium-flicker-hardware-acceleration.md): 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. - [Claude Code or agent CLI not found on Omarchy](https://omarchylinux.org/fix/claude-code-or-agent-cli-not-found.md): 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. - [Clipboard history not working on Omarchy 4](https://omarchylinux.org/fix/clipboard-history-not-working.md): 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. - [error: invalid value 'untrusted' for '--ask-for-approval'](https://omarchylinux.org/fix/codex-invalid-value-ask-for-approval.md): 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. - [command not found: elephant](https://omarchylinux.org/fix/command-not-found-elephant.md): 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](https://omarchylinux.org/fix/command-not-found-xdg-terminal-exec.md): Super+Return does nothing and menu entries fail with command not found: xdg-terminal-exec. Reinstall the package, then finish the interrupted Omarchy update. - [Creating a snapshot failed.](https://omarchylinux.org/fix/creating-a-snapshot-failed-snapper.md): 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. - [Cursor invisible, wrong size, or a black box on Omarchy](https://omarchylinux.org/fix/cursor-invisible-or-wrong-size.md): 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. - [Custom keybindings stopped working after upgrading to Omarchy 4](https://omarchylinux.org/fix/custom-keybindings-lost-after-quattro.md): 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. - [Voxtype dictation not working on Omarchy](https://omarchylinux.org/fix/dictation-voxtype-not-working.md): 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. - [permission denied while trying to connect to the docker API](https://omarchylinux.org/fix/docker-permission-denied-after-group-change.md): 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. - [Errors occurred, no packages were upgraded.](https://omarchylinux.org/fix/errors-occurred-no-packages-were-upgraded.md): 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. - [error: failed to commit transaction (failed to retrieve some files)](https://omarchylinux.org/fix/failed-to-retrieve-some-files-pacman.md): Pacman 404s from stable-mirror.omarchy.org usually mean stale package databases, not a broken mirror. Refresh with pacman -Syy, then run omarchy update. - [Fingerprint enrollment fails: Enrollment failed. Please try again.](https://omarchylinux.org/fix/fingerprint-enrollment-fails.md): 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. - [Fonts wrong or missing after an Omarchy update](https://omarchylinux.org/fix/fonts-wrong-or-missing-after-update.md): 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. - [Apps blurry or huge with fractional scaling on Omarchy](https://omarchylinux.org/fix/fractional-scaling-blurry-or-huge-apps.md): 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. - [Hibernate fails or hangs on Omarchy](https://omarchylinux.org/fix/hibernate-fails-or-hangs.md): 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. - [Hybrid GPU laptop black screen or login loop (AQ_DRM_DEVICES)](https://omarchylinux.org/fix/hybrid-gpu-laptop-black-screen-aq-drm-devices.md): 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. - [attempt to index a nil value (global 'o')](https://omarchylinux.org/fix/hyprland-lua-attempt-to-index-nil-global-o.md): 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. - [Omarchy installer fails or stalls partway through](https://omarchylinux.org/fix/install-fails-or-stalls.md): 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. - [Kernel panic after an Omarchy update (Limine boot menu)](https://omarchylinux.org/fix/kernel-panic-after-update-limine.md): 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. - [Omarchy lock screen will not unlock](https://omarchylinux.org/fix/lock-screen-wont-unlock.md): 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. - [SDDM login loop or password not accepted on Omarchy](https://omarchylinux.org/fix/login-loop-or-password-not-accepted-sddm.md): 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. - [LUKS passphrase not accepted at boot](https://omarchylinux.org/fix/luks-passphrase-not-accepted-at-boot.md): 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. - ["Something went wrong during the update!" on a migration](https://omarchylinux.org/fix/migration-failed-mid-update.md): 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. - [mise: command not found, or a mise wrapper that hangs or prints noise](https://omarchylinux.org/fix/mise-command-not-found-or-shims.md): 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. - [Monitor layout lost after Quattro: monitors.conf replaced by monitors.lua](https://omarchylinux.org/fix/monitors-conf-replaced-by-monitors-lua.md): 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](https://omarchylinux.org/fix/multi-monitor-layout-not-saved.md): 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. - [No sound from laptop speakers on Omarchy](https://omarchylinux.org/fix/no-sound-from-laptop-speakers.md): 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. - [Notifications not showing](https://omarchylinux.org/fix/notifications-not-showing.md): No notification toasts on Omarchy 4? Check do-not-disturb, find out which daemon owns org.freedesktop.Notifications, and test with notify-send. - [NVIDIA drivers on Omarchy 4](https://omarchylinux.org/fix/nvidia-drivers-omarchy-4.md): 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. - [omarchy update fails or hangs part way through](https://omarchylinux.org/fix/omarchy-update-fails-or-hangs.md): 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](https://omarchylinux.org/fix/pacnew-and-pacsave-files-after-update.md): 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. - [Omarchy shell plugin fails to load or the bar disappears](https://omarchylinux.org/fix/plugin-fails-to-load.md): 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. - [Printer not found on Omarchy](https://omarchylinux.org/fix/printer-not-found.md): 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. - [Quickshell crashes or the Omarchy bar is missing](https://omarchylinux.org/fix/quickshell-crashes-or-bar-missing.md): 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](https://omarchylinux.org/fix/screenshot-shortcut-not-working.md): 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. - [Secure Boot Violation, or the Omarchy USB will not boot](https://omarchylinux.org/fix/secure-boot-violation-or-wont-boot-uefi.md): 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. - [signature from "..." is unknown trust](https://omarchylinux.org/fix/signature-is-unknown-trust-keyring.md): Pacman aborts an Omarchy update with a signature is unknown trust error. Refresh archlinux-keyring, trust the Omarchy signing key, then retry the update. - [Steam or Proton game crashes on launch](https://omarchylinux.org/fix/steam-or-proton-game-crashes.md): Steam and Proton games that die seconds after launch on Omarchy 4: the lib32 driver check, leftover SDL_VIDEODRIVER, and the gamescope launch option. - [Stuck at a TTY, or cannot switch to a TTY on Omarchy](https://omarchylinux.org/fix/stuck-at-tty-or-cannot-switch-tty.md): 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. - [Laptop will not resume from suspend on Omarchy](https://omarchylinux.org/fix/suspend-wont-resume-s2idle.md): 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. - [Tailscale not connecting or DNS broken on Omarchy](https://omarchylinux.org/fix/tailscale-not-connecting.md): 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. - [GTK4 and libadwaita apps ignore the Omarchy theme](https://omarchylinux.org/fix/theme-not-applied-to-gtk4-apps.md): 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. - [Walker launcher missing after update](https://omarchylinux.org/fix/walker-launcher-missing-after-update.md): Omarchy 4 removed the Walker launcher. Super + Space now opens the Omarchy menu and Super + Alt + Space opens the apps-only launcher. - [Webcam not detected on Omarchy](https://omarchylinux.org/fix/webcam-not-detected.md): 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. - [Where did Waybar go after the Omarchy 4 update?](https://omarchylinux.org/fix/where-did-waybar-go.md): 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. - [Wi-Fi gone or dropping after a kernel update (iwlwifi, mt7921, brcmfmac)](https://omarchylinux.org/fix/wifi-drops-after-kernel-update-iwlwifi.md): Wi-Fi disappears or drops after an Omarchy kernel update: boot the previous Limine kernel entry, install matching headers, rebuild DKMS modules, fix firmware. - [You are in emergency mode after an Omarchy update](https://omarchylinux.org/fix/you-are-in-emergency-mode-after-update.md): 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. ## Hardware Does Omarchy run on this machine? Component and model reports, stamped by version. - [AMD GPUs on Omarchy](https://omarchylinux.org/hardware/amd-gpu.md): What works and what breaks on AMD Radeon graphics under Omarchy 4.x: kernel and firmware regressions, DPMS lock flaps, hybrid GPU env vars, fixes. - [Apple MacBook Air (Intel, T2) on Omarchy](https://omarchylinux.org/hardware/apple-macbook-air-intel.md): MacBook Air 2018 to 2020 with the Apple T2 chip on Omarchy 4.0.4: the linux-t2 kernel it gets, the suspend and Bluetooth bugs, what to check first. - [Intel MacBook Pro (2016-2020) on Omarchy](https://omarchylinux.org/hardware/apple-macbook-pro-intel.md): Intel MacBook Pro 2016-2020 on Omarchy 4.0.4: T2 models are supported and mostly work, 2016-2017 T1 models lose the Touch Bar and audio. - [Apple Silicon Macs and Asahi on Omarchy](https://omarchylinux.org/hardware/apple-silicon-asahi.md): Omarchy ships no Apple Silicon build. What runs on M-series Macs under Asahi, which quirk scripts misfire on aarch64, and the fixes people have verified. - [Apple Silicon Macs (M1 to M4) on Omarchy](https://omarchylinux.org/hardware/apple-silicon-macs.md): What actually runs on an M1 to M4 Mac in September 2026: the Try Omarchy app, the omarchy-mac Asahi install, the Omarchy M plan, and the open bugs. - [ASUS ROG Zephyrus and Strix on Omarchy](https://omarchylinux.org/hardware/asus-rog-zephyrus.md): ASUS ROG Zephyrus G14, G16 and Strix on Omarchy 4.0.4: bronze. asusctl and the hybrid GPU toggle ship, but hibernate, boot and audio still bite. - [ASUS Zenbook and Vivobook on Omarchy Linux](https://omarchylinux.org/hardware/asus-zenbook-vivobook.md): ASUS Zenbook and Vivobook on Omarchy 4.0.4: one UX5406AA backlight quirk ships, while audio, s2idle resume, fingerprint and Wi-Fi stay open. - [Audio on Omarchy Linux](https://omarchylinux.org/hardware/audio.md): How audio works on Omarchy 4.x: PipeWire defaults, the SOF firmware and speaker tuning install hooks, the bugs that still bite, and the fix order. - [Battery and power management on Omarchy](https://omarchylinux.org/hardware/battery-power.md): How battery reporting, power profiles and the low-battery warning behave on Omarchy 4.0.4, which laptops break, and the fix order that actually works. - [Beelink SER8, SER9 and other Beelink mini PCs on Omarchy](https://omarchylinux.org/hardware/beelink-ser.md): Beelink SER8, SER9, EQR and GTR mini PCs on Omarchy 4.0.4: suspend broken by Beelink firmware, Wi-Fi that can vanish until a power drain, and more. - [Bluetooth on Omarchy](https://omarchylinux.org/hardware/bluetooth.md): What works and what breaks in Bluetooth on Omarchy 4.0.4: the rfkill power model, Quickshell panel bugs, BLE mouse reconnects, and the fix order. - [Boot, Limine and LUKS on Omarchy 4.x](https://omarchylinux.org/hardware/boot-limine.md): How the Limine bootloader, the UKI, LUKS unlock and snapshot booting work on Omarchy 4.0.4, what breaks on real machines, and the order to fix it in. - [Dell Latitude on Omarchy Linux](https://omarchylinux.org/hardware/dell-latitude.md): Dell Latitude on Omarchy 4.x: Intel graphics and iwlwifi work, ControlVault fingerprint readers go undetected, and turning Bluetooth off can drop the radio. - [Dell XPS 13 (2026, DX13260) on Omarchy](https://omarchylinux.org/hardware/dell-xps-13-2026.md): Dell XPS 13 DX13260 on Omarchy 4.0.4: speakers are the big open problem, plus a Panel Replay judder and a suspend hang on the new kernel. - [Dell XPS 14 and XPS 16 (2026, Panther Lake) on Omarchy](https://omarchylinux.org/hardware/dell-xps-14-2026.md): Dell XPS 14 DA14260 and XPS 16 DA16260 on Omarchy 4.0.4: the enablement Omarchy ships, plus the open backlight, camera and Wi-Fi quirks. - [Dell XPS 15, XPS 17 and pre-2026 XPS on Omarchy](https://omarchylinux.org/hardware/dell-xps-15-and-older.md): Field notes on running Omarchy 4.x on the Dell XPS 15, XPS 17 and older XPS laptops: what is known, the Goodix fingerprint dead end, MIPI webcams and NVIDIA. - [Fingerprint readers on Omarchy](https://omarchylinux.org/hardware/fingerprint.md): Fingerprint readers on Omarchy 4.0.4: what enrolls out of the box, the omarchy-hw-fingerprint detection gaps, fprintd wedging after suspend, and the fix order. - [Framework Desktop (Strix Halo) on Omarchy](https://omarchylinux.org/hardware/framework-desktop.md): Framework Desktop (Ryzen AI Max 385/395) on Omarchy 4.0.4: the Strix Halo amdgpu lockups, the dual-monitor DPMS reset, 6K DSC limits, and what to check first. - [Framework Laptop 12 on Omarchy](https://omarchylinux.org/hardware/framework-laptop-12.md): Framework Laptop 12 on Omarchy 4.0.4: Intel Raptor Lake runs out of the box, but tablet mode is half done. Rotation, on-screen keyboard, touch gaps. - [Framework Laptop 13 on Omarchy](https://omarchylinux.org/hardware/framework-laptop-13.md): Framework Laptop 13 running Omarchy 4.0.4: what works, the AMD mic fix Omarchy ships, the suspend and USB-C dock bugs, and which generation to buy. - [Framework Laptop 16](https://omarchylinux.org/hardware/framework-laptop-16.md): Framework Laptop 16 on Omarchy 4.x: what the distro detects and installs for it, the qmk-hid install failure, the theme-set hang, and the dGPU wake bug. - [HP EliteBook, Spectre, Envy and Omen on Omarchy Linux](https://omarchylinux.org/hardware/hp-elitebook-spectre.md): HP EliteBook, Spectre x360, Envy and Omen support on Omarchy 4.x: no HP-specific enablement, broken webcams on Meteor Lake, flaky s2idle resume. - [Hybrid and dual GPU laptops on Omarchy](https://omarchylinux.org/hardware/hybrid-gpu.md): What works and what breaks on Intel or AMD iGPU plus NVIDIA dGPU laptops running Omarchy 4.x, with the real issue numbers, the quirk scripts, and the fix order. - [Intel GPUs on Omarchy](https://omarchylinux.org/hardware/intel-gpu.md): Intel GPU support in Omarchy 4.x: what the installer sets up, the hybrid LIBVA_DRIVER_NAME bug, Panther Lake panel quirks, and the fix order that works. - [Lenovo IdeaPad on Omarchy](https://omarchylinux.org/hardware/lenovo-ideapad.md): Lenovo IdeaPad on Omarchy 4.0.4: modern Intel and AMD models install and run, MX150 models still abort the installer, and Omarchy ships no IdeaPad enablement. - [Lenovo Legion gaming laptops on Omarchy](https://omarchylinux.org/hardware/lenovo-legion.md): Lenovo Legion 5, 7 and Pro on Omarchy 4.0.4: bronze. The generic NVIDIA path installs cleanly, but suspend, brightness and video decode keep failing. - [Lenovo ThinkPad T14 and T14s (Gen 1 to Gen 6) on Omarchy](https://omarchylinux.org/hardware/lenovo-thinkpad-t14.md): ThinkPad T14 and T14s on Omarchy 4.0.4: a silver buy with known AMD s2idle, lid-wake, Wi-Fi firmware and fwupd quirks to check first. - [Lenovo ThinkPad T480 and T480s on Omarchy](https://omarchylinux.org/hardware/lenovo-thinkpad-t480.md): ThinkPad T480 and T480s on Omarchy 4.0.4: Intel UHD 620 needs no setup, the dual-battery readout is wrong, and the Validity fingerprint reader never enrolls. - [Lenovo ThinkPad X1 Carbon on Omarchy](https://omarchylinux.org/hardware/lenovo-thinkpad-x1-carbon.md): Omarchy on the ThinkPad X1 Carbon Gen 8 to Gen 14: what works, the Gen 13 speaker and Gen 14 camera breakage, and the hardware scripts that fire. - [Lenovo ThinkPad X220, X230, T420 and T430 on Omarchy Linux](https://omarchylinux.org/hardware/lenovo-thinkpad-x220-and-classics.md): Classic ThinkPads on Omarchy 4.0.4: the X220 is the project's own potato demo, but scaling, VA-API, dictation and dual-battery reporting all need hand work. - [Lenovo Yoga on Omarchy Linux](https://omarchylinux.org/hardware/lenovo-yoga.md): Lenovo Yoga support on Omarchy 4.0.4: the Yoga Pro 7 14IAH10 gets a bass speaker quirk, but touchpad, USB-C display and older-BIOS boot problems are open. - [Microsoft Surface on Omarchy Linux](https://omarchylinux.org/hardware/microsoft-surface.md): Microsoft Surface Laptop and Surface Pro on Omarchy 4.0.4: the keyboard works after boot but often dies at the LUKS prompt, and touch needs linux-surface. - [Minisforum mini PCs on Omarchy](https://omarchylinux.org/hardware/minisforum.md): Minisforum UM790, UM870, EliteMini and AI X1 Pro on Omarchy 4.0.4: the amdgpu dcn31 panics, slow resume, the fingerprint gate, and a DMI quirk. - [MSI laptops on Omarchy](https://omarchylinux.org/hardware/msi-laptops.md): MSI Titan, Stealth, Raider, Katana, Bravo and GL series on Omarchy 4.0.4: bronze. No MSI enablement ships, so fans, EC and hybrid GPU are all manual. - [Multi-monitor on Omarchy 4](https://omarchylinux.org/hardware/multi-monitor.md): What works and what breaks with multi-monitor setups on Omarchy 4.0.4: clamshell handling, per-monitor scaling, wake failures and the fixes that hold. - [NVIDIA on Omarchy](https://omarchylinux.org/hardware/nvidia.md): NVIDIA GPUs on Omarchy 4.0.4: driver selection by GPU generation, hybrid laptop video decode corruption, kernel module failures, and the fix order. - [Printers and printing on Omarchy](https://omarchylinux.org/hardware/printer.md): CUPS ships enabled on Omarchy 4.0.4, but automatic printer discovery was removed in 4.0.2 and no HP or scanner drivers ship. What works and what to install. - [Slimbook and TUXEDO on Omarchy Linux](https://omarchylinux.org/hardware/slimbook-and-tuxedo.md): Slimbook and TUXEDO on Omarchy 4.0.4: the vendor-wide backlight and ethernet quirk scripts, the 3.8.4 suspend regression, what to check first. - [Steam Deck, Legion Go and ROG Ally on Omarchy](https://omarchylinux.org/hardware/steam-deck-and-handhelds.md): Omarchy on handheld PCs: Steam Deck, Legion Go and ROG Ally. Experimental, no handheld enablement in the installer, and the known open bugs in 4.0.4. - [Storage, NVMe and filesystems on Omarchy](https://omarchylinux.org/hardware/storage-nvme.md): What works and what breaks for NVMe, SSD, btrfs, LUKS and the EFI partition on Omarchy 4.x, with real issue numbers, the Apple NVMe quirk script, and fixes. - [Suspend, sleep and resume on Omarchy](https://omarchylinux.org/hardware/suspend-sleep.md): What suspend, sleep and resume actually do on Omarchy 4.x: the lock-before-sleep path, the sleep hooks it ships, the models that break, and the fix order. - [Intel Macs with the Apple T2 chip on Omarchy](https://omarchylinux.org/hardware/t2-mac.md): What works and what breaks on T2 Macs running Omarchy 4.x: the linux-t2 kernel, the quirk scripts the installer applies, open issues, and the fix order. - [Thunderbolt and USB-C docks on Omarchy 4](https://omarchylinux.org/hardware/thunderbolt-dock.md): What works and what breaks with Thunderbolt and USB-C docks on Omarchy 4.0.4: the early thunderbolt module, bolt authorization, DP alt mode wedges and fixes. - [Touchpad, keyboard and input on Omarchy](https://omarchylinux.org/hardware/touchpad-input.md): What the touchpad and keyboard stack does on Omarchy 4.x: the defaults in input.lua, the quirk scripts, the i2c-hid failures that break pads, and the fix order. - [Omarchy in a virtual machine](https://omarchylinux.org/hardware/vm.md): What works and what breaks when Omarchy 4.x runs as a guest in VMware, VirtualBox, QEMU/KVM, Proxmox, UTM or Parallels, and the fixes people verified. - [Webcams on Omarchy](https://omarchylinux.org/hardware/webcam.md): USB webcams work on Omarchy 4.0.4. Built-in MIPI cameras behind Intel IPU6 or IPU7 are the hard part: what Omarchy installs, what breaks, and the fix order. - [Wi-Fi on Omarchy](https://omarchylinux.org/hardware/wifi.md): Wi-Fi on Omarchy 4.x runs on NetworkManager. What the installer sets up, the quirk scripts it ships, the Broadcom Mac and 802.1X panel bugs, and the fix order. ## Switching Coming from macOS or Windows: what blocks you on day one and what replaces what. - [Omarchy 4 day-one checklist: your first 48 hours](https://omarchylinux.org/switch/day-one-checklist.md): A first 48 hours checklist for Omarchy 4.0.4: what to set up first, and the open issues that block keyboard layout, screen sharing, scaling and printing. - [Fractional scaling and HiDPI apps on Omarchy](https://omarchylinux.org/switch/fractional-scaling-hidpi-apps.md): How to set fractional scaling on Omarchy 4.x in monitors.lua, why Electron, Chromium and XWayland apps look blurry or oversized, and what to do about each. - [Switching from macOS to Omarchy: the honest day-one guide](https://omarchylinux.org/switch/from-macos.md): What actually changes when you move from macOS to Omarchy 4.0.4: which Macs can run it, how Cmd becomes Super, and what the official manual leaves out. - [Switching from Windows 11 to Omarchy Linux](https://omarchylinux.org/switch/from-windows.md): What actually changes moving from Windows 11 to Omarchy 4.0.4: trying it in a window first, dual boot traps, Secure Boot, the Super key, and gaming. - [Non-US keyboard layouts: LUKS, SDDM and Hyprland](https://omarchylinux.org/switch/non-us-keyboard-layout-luks-sddm.md): On Omarchy 4.0.x your keyboard layout has to be set in three separate places. Fix the LUKS prompt, the Hyprland session and the SDDM greeter. - [Printers and scanners on Omarchy](https://omarchylinux.org/switch/printers-and-scanners.md): How printing works on Omarchy 4.0.4: CUPS and avahi ship enabled, you add each printer by hand in Print Settings, and scanning needs SANE installed. - [Screen sharing in Google Meet, Zoom and Teams on Omarchy](https://omarchylinux.org/switch/screen-sharing-meet-zoom-teams.md): How screen sharing works on Omarchy 4.x: the Hyprland portal picker, the stuck sharing bar, missing monitors in the Outputs tab, and Meet glitches. - [Should you dual boot Omarchy with Windows or macOS?](https://omarchylinux.org/switch/should-you-dual-boot.md): Dual booting Omarchy with Windows works but the free-space installer has real traps. macOS dual boot is unsupported. When to use a VM instead. - [Surviving a tiling window manager in Omarchy](https://omarchylinux.org/switch/tiling-window-manager-survival.md): How Omarchy 4's tiling window manager actually works, the twelve Hyprland keybindings that matter, and how to make it feel like macOS or Windows. - [What replaces what: macOS and Windows apps in Omarchy](https://omarchylinux.org/switch/what-replaces-what.md): Which Omarchy app replaces Alfred, Rectangle, Time Machine, Explorer, Office and the rest. A replacement matrix for switchers, checked against 4.0.4. ## Security Every reported Omarchy security issue mapped to the fix and the release it shipped in. - [Omarchy development practices and AI-written code](https://omarchylinux.org/security/development-practices-and-ai-written-code.md): The claim that Omarchy's AI-written bash and fast release cadence cause security bugs, with the checkable evidence on both sides, as of v4.0.4. - [Docker group root escalation fixed in Omarchy 4.0.1](https://omarchylinux.org/security/docker-group-root-escalation.md): The docker group on Omarchy was root-equivalent and granted by default. What the August 2026 root escalation was, and how to check your machine. - [omarchy plugin add clones upstream HEAD with no pin](https://omarchylinux.org/security/install-commands-clone-mutable-head.md): omarchy plugin add and omarchy theme install do a bare git clone of a repo's current HEAD. No commit pin, no signature. What that means and how to pin yourself. - [Is Omarchy safe to use? The defaults, the criticisms, the fixes](https://omarchylinux.org/security/is-omarchy-safe.md): A sourced look at Omarchy security: mandatory LUKS, ufw default deny, the docker group root escalation, and the hardening that shipped in 4.0.1 through 4.0.3. - [What Omarchy encrypts and firewalls by default](https://omarchylinux.org/security/luks-and-ufw-defaults.md): Omarchy ships LUKS full-disk encryption and ufw set to deny incoming, with port 53317 open for LocalSend and ufw-docker rules. What that covers and misses. - [Notification and video title bash injection in Omarchy 4.0.0](https://omarchylinux.org/security/notification-and-title-bash-injection.md): In Omarchy 4.0.0 a web page's video title could reach the command run when you clicked the Download complete toast. Fixed in 4.0.1 by PR 7847 and PR 7926. - [Omarchy's passwordless sudo window: risk and how to shorten it](https://omarchylinux.org/security/passwordless-sudo-window.md): What Omarchy's temporary passwordless sudo window does, the NOPASSWD sudoers file it writes, the real risk, and how to end it early or shorten it. - [Omarchy shell plugins run unsandboxed inside omarchy-shell](https://omarchylinux.org/security/plugins-run-unsandboxed.md): Omarchy 4 shell plugins are QML loaded into the long-lived omarchy-shell process with your full user rights. What 4.0.3 scoped, and how to vet a plugin. - [Verify an Omarchy ISO: signing key, .sha256 and .sig files](https://omarchylinux.org/security/signing-key-and-iso-verification.md): How to verify an Omarchy ISO: the pkgs@omarchy.org signing key fingerprint, the .sha256 and .sig sidecar files, and commands for Linux, macOS and Windows. - [Stable mirror lag vs Arch upstream, and what it costs you](https://omarchylinux.org/security/stable-mirror-lag-and-cves.md): How far behind Arch the Omarchy stable mirror really runs, measured 2026-09-17, what it cost during the Chromium exploit, and how to switch channels. - [cidata drives store the LUKS passphrase in plaintext](https://omarchylinux.org/security/unattended-install-plaintext-passphrase.md): Omarchy's unattended install reads a cidata drive whose config carries the LUKS passphrase in plaintext. The risk, and the defer-provisioning path. ## Keyboards and input Layouts, locale, and typing in Chinese, Japanese, and Korean on Omarchy 4. - [Typing Chinese on Omarchy 4 with fcitx5](https://omarchylinux.org/keyboard/chinese-input-fcitx5.md): Omarchy 4 already runs fcitx5 as a service. Add fcitx5-chinese-addons or Rime, pick a toggle key that is not Shift or Ctrl+Space, and verify it works. - [Japanese input on Omarchy 4 with fcitx5-mozc](https://omarchylinux.org/keyboard/japanese-input-mozc.md): Set up Japanese typing on Omarchy 4.0.x: install fcitx5-mozc, register it with the running fcitx5, pick a toggle key, and fix the Chromium and fullscreen gaps. - [Typing Korean on Omarchy 4 with fcitx5-hangul](https://omarchylinux.org/keyboard/korean-input-hangul.md): Omarchy 4 ships fcitx5 but no Korean engine and no Korean keyboard choice at install. Add fcitx5-hangul, register it, and type Hangul. - [Keyboard layouts and locale on Omarchy 4](https://omarchylinux.org/keyboard/layouts-and-locale.md): Where Omarchy 4 reads your keyboard layout, how to add and switch layouts in input.lua, the LUKS non-Latin trap, and why the clock stays English. ## Comparisons Omarchy against the distros people actually decide between, verified against versions. - [Omarchy vs building Arch + Hyprland yourself](https://omarchylinux.org/vs/arch-linux-from-scratch.md): What Omarchy 4.0.4 adds on top of a hand-built Arch and Hyprland desktop, what control you give up, and which of the two you should actually install. - [Omarchy vs CachyOS: which one, and can you run both?](https://omarchylinux.org/vs/cachyos.md): Omarchy 4.0.4 and CachyOS compared on install, kernel, desktop, gaming, updates and support, plus why the Omarchy on CachyOS scripts are stuck on 3.x. - [Omarchy vs Debian, Ubuntu and Linux Mint: should you switch?](https://omarchylinux.org/vs/debian-ubuntu-mint.md): Omarchy vs Debian, Ubuntu and Linux Mint: rolling Arch against point releases, pacman against apt, Hyprland against GNOME and Cinnamon, and who should stay put. - [Omarchy forks and ports: which ones are still alive](https://omarchylinux.org/vs/forks-and-ports.md): A health check on every Omarchy fork and port, from omarchy-mac and Nixarchy to omadora, okimarchy and the CachyOS scripts: who rebased onto Quattro 4.x. - [Omarchy vs Omakub: the retired Ubuntu predecessor](https://omarchylinux.org/vs/omakub.md): Omakub was DHH's Ubuntu and GNOME setup script, now retired and archived. What it was, why Omarchy replaced it, and the two migration paths. ## Upgrades What an Omarchy upgrade does to your machine and what to do before and after. - [Upgrading Omarchy 3.x to 4 (Quattro)](https://omarchylinux.org/upgrade/3-to-4-quattro.md): What the Omarchy 3.x to 4 Quattro upgrade changes, what omarchy-upgrade-to-quattro actually does, and which of your configs silently stop loading. - [Before you run omarchy update: a pre-flight checklist](https://omarchylinux.org/upgrade/before-you-update-checklist.md): A pre-flight checklist for omarchy update on Omarchy 4.0.4: check your channel, free space, snapshots and pending migrations, then handle pacnew files yourself. - [Docker to Podman on Omarchy: what shipped and what has not](https://omarchylinux.org/upgrade/docker-to-podman.md): Omarchy 4.0.1 made the docker group opt-in. Podman is still an unmerged branch. What is shipped, what is pending, and how to prepare now. - [Roll back a bad Omarchy update with snapper and Limine](https://omarchylinux.org/upgrade/rollback-with-snapper-and-limine.md): How to roll back a bad Omarchy update using Btrfs snapshots, snapper and the Limine boot menu, plus what a snapshot restore does not cover. - [What Omarchy migrations do and how to read them](https://omarchylinux.org/upgrade/what-migrations-do.md): Omarchy migrations are one-time repair scripts in migrations/*.sh. How omarchy-migrate runs them, how to preview them, and what to do when one aborts an update. ## Is it official? Which Omarchy sites, domains, and accounts are official, and the trademark facts. - [How to spot a fake Omarchy site or download](https://omarchylinux.org/official/how-to-spot-a-fake-omarchy-site.md): Check the domain, the download, and the signature. The omarchy.net clone, the real download source, the signing key, and the red flags that give a fake away. - [Naming your Omarchy plugin, theme, or site safely](https://omarchylinux.org/official/naming-your-omarchy-project.md): The de facto rules for using the Omarchy name in a plugin, theme, fork, meetup, or community site, drawn from what the project has written and what has actually been enforced. - [Is Omarchy a trademark? The registration facts](https://omarchylinux.org/official/trademark.md): OMARCHY is a registered US trademark of 37signals LLC, not pending, registered 12 May 2026 in Class 9. What that means for community sites, plugins, and themes that use the name. ## Reference Commands, keybindings, menu tree, hooks, and config, generated from source per version. - [Hyprland .conf to Omarchy 4 Lua migration](https://omarchylinux.org/reference/hyprland-conf-to-lua-migration.md): Port a customized Omarchy 3.x ~/.config/hypr/*.conf setup to Omarchy 4 Lua: the o.bind and hl.* API, worked examples, and why bindings.conf stopped loading. - [Is that Omarchy guide still true on 4.x?](https://omarchylinux.org/reference/still-true-guides-and-videos.md): A dated verdict on the most-watched Omarchy videos and cheat sheets, which ones still work on Omarchy 4.0.4, which describe a desktop that is gone. ## Run anywhere Omarchy in VirtualBox, VMware, Proxmox, Hyper-V, Apple Silicon, and more, with verdicts. - [Run Omarchy in Hyper-V on Windows 11](https://omarchylinux.org/run/hyper-v.md): Omarchy in Hyper-V: Generation 2 VM with Secure Boot off, fixed resolution via Set-VMVideo, the invisible LUKS prompt, and why there is no audio or GPU. - [Run Omarchy 4 in Parallels Desktop on Intel and Apple Silicon](https://omarchylinux.org/run/parallels.md): Omarchy 4 in Parallels Desktop: the Intel Mac route that works, the repeat_delay double-character fix, and why Apple Silicon has no supported path. - [Omarchy 4 in Proxmox, QEMU/KVM and virt-manager](https://omarchylinux.org/run/proxmox-qemu-kvm.md): Running Omarchy 4 as a QEMU/KVM guest under Proxmox or virt-manager: OVMF firmware, q35, virtio disk and display, guest agents, and the verified bugs. - [Omarchy on Raspberry Pi 5 and ARM boards](https://omarchylinux.org/run/raspberry-pi-5.md): Omarchy has no official aarch64 build. What the edge channel actually publishes for ARM, what breaks on a Raspberry Pi 5, and the path that works. - [Omarchy on the Steam Deck: deckarchy, gaming mode, SteamOS](https://omarchylinux.org/run/steam-deck.md): What it takes to run Omarchy 4 on a Steam Deck, why the deckarchy Neptune kernel script predates Quattro, and where the gaming mode plugins fit. - [Unattended Omarchy installs with a cloud-init cidata drive](https://omarchylinux.org/run/unattended-install-cidata.md): Build a NoCloud cidata drive so the Omarchy 4 ISO installs itself: the exact file set, genisoimage and Proxmox commands, SSH keys, and the passphrase risk. - [Omarchy on Apple Silicon: UTM, Try Omarchy, omarchy-mac](https://omarchylinux.org/run/utm-apple-silicon.md): There is no official Apple Silicon build of Omarchy 4. The three working routes in 2026: Try Omarchy, omarchy-mac on Asahi, and a native aarch64 UTM VM. - [Run Omarchy 4 in VirtualBox: settings, fixes, guest additions](https://omarchylinux.org/run/virtualbox.md): How to run Omarchy 4 in VirtualBox: VMSVGA with 3D acceleration, 128 MB VRAM, guest additions, and the software GL fix for the black screen. - [Running Omarchy in VMware Workstation and Fusion](https://omarchylinux.org/run/vmware-workstation-fusion.md): Omarchy 4.x in VMware Workstation or Fusion: VM settings, the vmwgfx grey screen fix, open-vm-tools, guest resolution, clipboard, and the invisible cursor. - [What breaks when you run Omarchy 4 in a VM](https://omarchylinux.org/run/what-breaks-in-a-vm.md): Black screen, dead Super key, tiny resolution, missing guest tools, invisible cursor and clipboard: what breaks in an Omarchy 4 VM and how to fix each one. - [Omarchy on WSL2: Hyprland will not run, and what to do instead](https://omarchylinux.org/run/wsl2.md): Omarchy on WSL2: Hyprland cannot start because WSL2 exposes no DRM node. What community .wsl images actually give you, and how to get the real desktop. ## Generated reference - [All commands](https://omarchylinux.org/reference/commands/): every omarchy CLI command with summary, args, and examples, per version - [Keybindings](https://omarchylinux.org/reference/keybindings/): every default Hyprland binding with its label - [What changed between versions](https://omarchylinux.org/reference/changes/) - [Releases and channels](https://omarchylinux.org/releases/) - [Which sites are official](https://omarchylinux.org/official/)