mrkeyoor.com_
Sun 16 Aug 14:44 UTC
Dev Toolsevaluationupdated 16 Aug 2026

omarchy

Omarchy is an opinionated Arch Linux distribution that turns a bare PC into a keyboard-driven Hyprland workstation with a themed desktop and a large set of developer tools. It solves the tedious job of assembling, styling, and maintaining an Arch-based coding environment, but it does so by making many choices for you.

Verdict

Omarchy is compelling if its screenshots, shortcuts, and chosen applications already resemble the workstation you want. It saves weeks of desktop assembly and now offers a much more coherent shell, but Quattro is a fresh architectural rewrite with serious open upgrade and locking reports. Try it on supported spare hardware first, then move a primary machine only after you are comfortable recovering Arch and restoring snapshots.

Setup4/5Fast ISO install, with firmware, disk, and hardware caveats
Docs5/5A detailed 52-part manual covers daily use and recovery
Community5/5Large adoption with intense same-day issue and pull-request activity
Maturity3/5Capable daily driver, but Quattro introduces fresh regressions

Who it’s for

Developers who want a polished, keyboard-first Linux workstation without building an Arch and Hyprland setup by hand.
Experienced Linux users who like rolling releases but want coordinated updates, migrations, and automatic snapshots.
Small teams or computer builders preparing encrypted developer machines for another owner.
Tinkerers who will use documented dotfile overrides, hooks, themes, and shell plugins instead of replacing the distribution's internals.

Who it’s NOT for

Organizations that require Secure Boot or TPM to stay enabled: the installation guide explicitly tells users to disable them in firmware.
People who want a conventional GNOME or KDE desktop with mouse-led settings: Omarchy is built around Hyprland, keyboard shortcuts, Neovim, and strongly chosen defaults.
Anyone who cannot risk upgrade recovery on their primary machine: open Quattro reports include a system failing to boot after upgrade, a lock screen that does not engage, and a legacy migration queue stopping after one failure.
Owners of unusual display or GPU setups who expect broad vendor-tested compatibility: current reports cover mixed-monitor scaling, Quickshell crashes, and NVIDIA-related setup problems.
Users who want to run normal pacman -Syu or freely edit distribution-owned files: Omarchy blocks direct system upgrades by default and overwrites changes under /usr/share/omarchy.

Setup reality

The installer itself is unusually quick for a complete Linux workstation: write the roughly 6 GB ISO to USB, disable Secure Boot or TPM, boot it, answer the prompts, and let it install. The README says the process can finish in under five minutes, but the consequential work happens around that short wizard: back up the machine, decide whether to wipe the disk or create free space for dual boot, disable BitLocker when sharing a Windows drive, verify hardware support, and keep a wired or 2.4 GHz keyboard available for the encrypted boot prompt. Existing Omarchy users face migrations and a major desktop-shell transition, so upgrading deserves a current snapshot and a recovery plan.

A whole workstation, not a theme pack

Omarchy is a finished opinion about how a developer's Linux computer should work. It starts with Arch Linux and Hyprland, then supplies the shell, applications, shortcuts, themes, update path, recovery tools, and documentation needed to make that combination feel like one product. The target user is not someone shopping for a neutral Linux base. It is a developer who sees the Omarchy workflow and wants most of it immediately.

Version 4.0, called Quattro, makes that argument clearer. The project replaced Waybar, Walker, Mako, SwayOSD, hyprlock, and several other desktop pieces with one long-running Quickshell process. The bar, launcher, menus, notifications, display controls, lock screen, and permission prompts now share styling and an extension model. That consolidation is a meaningful improvement over personal dotfiles where every component has its own configuration and failure mode.

The result is broad: visual themes, clipboard history, screen capture, dictation, window layouts, network and Bluetooth panels, developer tools, and many keyboard bindings. Quattro also adds a configurable coding-agent launcher, a plugin system, and small default applications for writing, trimming video, and calculation. It feels built for daily work rather than one attractive screenshot.

The opinion is both product and cost

Omarchy saves time because it refuses to begin with an empty settings screen. Foot is the default terminal, Neovim is the default editor, Hyprland controls windows, and the Omarchy menu exposes common actions. Developers coming from macOS or Windows get a manual section dedicated to the transition. Daily tasks have named shortcuts, with searchable access when a shortcut is forgotten.

Customization is more disciplined than the prescriptive image suggests. User changes belong under ~/.config, with separate Lua files for Hyprland bindings, monitors, input, appearance, and startup programs. Menu extensions live in JSONC, while executable hooks can react after boot, after updates, before package refreshes, and on theme or battery events. Omarchy-owned files live under /usr/share/omarchy and arrive as packages, separating personal overrides from distribution internals.

That boundary also tells experienced Arch users what they cannot do casually. Editing system-owned files is temporary because updates can replace them. Direct pacman -Syu and yay -Syu upgrades are blocked unless deliberately bypassed, because they skip Omarchy's snapshot, migrations, and configuration changes. The protective layer is central to keeping a heavily integrated rolling desktop together.

Installation is fast, preparation is not

New installations use a bootable ISO and offer either a full-disk install or unallocated space. Encryption is enabled by default. The project says installation should take no more than five minutes and can take less than one minute on fast hardware. That describes automated copying and configuration, not the complete migration to a new operating system.

The surrounding decisions deserve care. A full-disk installation wipes the selected drive. Dual boot requires free space, and Windows users must turn off BitLocker first. The guide also requires disabling Secure Boot or TPM in firmware. Full-disk encryption means a Bluetooth keyboard cannot enter the early boot password, so users need a cable or 2.4 GHz receiver. These are important constraints when the computer contains paid work or belongs to an employer.

Omarchy can defer personal setup when preparing a machine for someone else, and it supports unattended installation from configuration on a second drive. Quattro adds a factory-reset flow based on a snapshot created during new installation. Those features make it more credible for small fleets and computer builders than most desktop configuration projects, though operators must validate their hardware.

Updates have guardrails and real risk

The stable channel coordinates Omarchy releases with an Arch mirror held one month behind current packages. Edge follows current Arch, RC previews major releases, and dev combines edge packages with a source checkout. Before updates, Omarchy uses snapshots; after a bad update, the manual tells users to choose the earlier snapshot in the boot menu. A reinstall command can restore default packages and configuration, while overwriting local config changes.

Those protections matter because Quattro is a large rewrite. Current issue reports include a machine dropping into an emergency shell after upgrading, a lock action that appears successful but leaves the desktop usable, and a partly upgraded legacy installation whose migration command hid pending work and then stopped the queue. Other reports concern mixed-monitor behavior and Quickshell crashes. Each is an individual report rather than proof every installation is affected, but a lock failure and failed boot justify caution.

Maintenance is exceptionally active. The repository was pushed on August 16, 2026, two days after the 4.0.0 release, and issues and pull requests were changing throughout the day. GitHub reports 657 combined open issues and pull requests, a large queue reflecting adoption and major-release churn. This is active software, not a quiet stable platform.

Documentation and the final choice

The manual is one of Omarchy's strongest assets. Its 52 sections cover onboarding, navigation, applications, updates, dotfiles, hardware, recovery, security, dual boot, and unattended installation. It explains approved customization paths and escape hatches for experienced users. Release notes are similarly detailed and include upgrade instructions plus a warning to back up important data.

Choose Omarchy when you want this particular environment and would otherwise spend nights reproducing it. Its coherence, recovery model, customization boundaries, and documentation put it beyond a dotfiles bundle. Do not treat it as a risk-free shortcut to Arch. Install it on spare hardware, exercise suspend, locking, displays, audio, updates, and snapshot recovery, then decide whether its strong opinions have earned control of your daily computer.

Alternatives

ProjectWhat it isPick it when
ArchinstallThe official guided Arch installer provides a cleaner base with fewer desktop opinions.pick this instead when you want Arch Linux but prefer choosing and maintaining the desktop stack yourself.
CachyOSAn Arch-based distribution focused on performance with several desktop choices.pick this instead when optimized packages and a choice of desktop environments matter more than Omarchy's unified design.
EndeavourOSA close-to-Arch distribution with an approachable installer and less prescribed workflow.pick this instead when you want a friendly Arch starting point without adopting one person's complete workstation philosophy.

What people are saying

  1. [github-trending] basecamp/omarchy

Sources

  1. Omarchy README and manual index
  2. Omarchy 4.0.0 Quattro release notes
  3. Getting Started installation guide
  4. Omarchy updates and rollback guide
  5. Quattro lock screen failure report
  6. Quattro upgrade boot failure report
  7. Legacy migration failure report