Omarchy: an opinionated Arch install that ships someone else's taste

Most Linux distributions hand you a foundation and a shrug. Omarchy hands you a finished desk.

It is an omakase Linux distribution based on Arch, the tiling window manager Hyprland, and the desktop construction-kit Quickshell. "Omakase" is the sushi term: you don't order, the chef decides. In this case the chef is DHH, and the distribution is the answer to a specific question — what if someone spent a year making all the tiling-WM decisions for you, and you just used the result?

The project is MIT licensed, incubated at 37signals, and is now on version 4.x.

What it actually is

Strip the branding and Omarchy is three things stacked:

1. An installer. An ISO that provisions Arch with full-disk encryption, sane partitioning, and a working graphical session in a few minutes.
2. A configuration layer. Hyprland, Quickshell, a top bar, a theming system, a unified keybinding scheme, and dotfiles for tmux, Neovim, and your shell.
3. A curated software set. Neovim, Chromium, Obsidian, LibreOffice, Kdenlive, OBS Studio, and more.

The repo itself is 82% shell, 8% Lua, sitting at around 4,300 commits. That composition tells you the honest truth about the project: it is a very well-maintained pile of install scripts and config files, not a novel operating system. That is not a criticism. It's the reason you can read it, fork it, and steal from it.

The framing in the manual is explicit about what it's optimizing for: a beautiful system is a motivating system, and productivity has always been downstream from motivation. Whether you buy that argument will largely determine whether this distribution is for you.

Installation

You download the ISO, write it to a USB stick, boot off it, and answer a few configuration questions. It can be done in under a minute on the fastest modern machines, but it shouldn't take more than 5 minutes even on an older computer.

Three things to know before you start:

Secure Boot has to go. You must turn off Secure Boot and/or TPM in the BIOS to be able to install Omarchy. If your machine is corporate-managed or you dual-boot Windows with BitLocker on, plan for that.

Encryption is the default and it changes your keyboard requirements. The installation defaults to full encryption, and the full-disk encryption won't allow you to enter the password from a Bluetooth keyboard at startup. You need a wired or 2.4GHz keyboard for the boot prompt. You can hit Ctrl + C on the disk formatting confirmation to switch to an encryption-less installation if you're building a throwaway box.

You can dual boot. You can choose between a full-disk install, which takes over the entire drive, or a free-space install, which puts Omarchy in the unallocated space on a drive. The full-disk option will wipe the selected drive, so back up first.

Two installer details I didn't expect and think are genuinely well designed:

If you're setting up a machine for someone else, hit Ctrl + C on the very first screen and Omarchy will prepare the machine for another owner instead. The system installs right away, but keyboard layout, username, and password are deferred until first boot, and the password the new owner picks becomes the encryption password.

The ISO can also install completely on its own — no keyboard, no wizard — when it's handed its configuration on a second drive, which is how you treat Omarchy as a base image for VMs and fleet machines.

That second one is the part most reviews skip, and it's the one that makes this interesting beyond a personal laptop.

The keyboard-first part

Omarchy is a tiling window manager setup, so almost everything is a binding. Super + K shows you all of them, which is the only hotkey you actually need to memorize on day one.

A representative slice:

Hotkey	Function
Super + Space	Omarchy menu (apps and everything else)
Super + Return	Terminal
Super + Shift + Return	Browser
Super + Shift + N	Neovim
Super + Arrow	Move focus in that direction
Super + Shift + Arrow	Swap window in that direction
Super + 1/2/3/4	Jump to workspace
Super + F	Full screen
Super + T	Toggle tiling/floating
Super + Ctrl + Shift + Space	Pick a new theme

The one I want to call out separately is the clipboard. On most Linux desktops you need Ctrl + Shift + C/V in the terminal and Ctrl + C/V everywhere else. Omarchy binds Super + C, Super + X, and Super + V and they work in both places. It is a small thing that removes a daily papercut, and it is a good example of what "opinionated" buys you: someone noticed the inconsistency and just fixed it globally.

Bindings live in ~/.config/hypr/bindings.lua. Lua config rather than a bespoke DSL, which means real conditionals and loops if you want them.

There is also a tmux layer with its own binding set (Super + Alt + K to view), including layout helpers like tdl <ai> to spin up an editor + AI + terminal pane arrangement in one command.

The AI-workstation angle

This is where Omarchy 4 diverges from being "a nice Hyprland config." A few of the defaults are built around agentic coding:

• Super + Ctrl + Return opens Herdr, an agent manager, with its own binding set under Super + Ctrl + K
• Super + Shift + Ctrl + A opens an agent picker
• The tmux layout functions take an AI argument as a first-class parameter
• Dictation is a first-class install option, with push-to-talk on F9 and toggle on Super + Ctrl + X
• Super + Ctrl + Print Screen does OCR text extraction from anything on screen straight to the clipboard

If you run coding agents in terminals all day, the shape of this system was designed by someone doing the same thing.

The maintenance question

The usual worry with a one-person opinionated distribution is what happens when that person moves on. Omarchy just answered it with money: the Omacom Foundation was incorporated as a nonprofit to hold the trademarks, fund the infrastructure, promote the work, and support the open-source projects and developers Omarchy depends on. Eight founding patrons contributed $1 million each, including Tobi Lütke, Patrick Collison, Michael Dell, Jack Dorsey, Matthew Prince, Brendan Iribe, and Jason Fried, with a further $2 million added from Drew Houston and Peter Steinberger.

Ten million dollars does not guarantee good software. What it does buy is runway, infrastructure, and a reason to believe the ISO will still be built in three years. For a distribution you'd put on a work machine, that matters more than any feature.

Where I'd push back

It is Arch underneath, with everything that implies. Rolling release, no LTS, and when something breaks mid-week you are debugging Arch. Omarchy ships system snapshots to soften this, but the failure modes are Arch's failure modes.

Secure Boot off is a real cost for some people. If your employer requires it, or you want measured boot as part of your threat model, this is a non-starter and no amount of theming fixes it.

Is it worth a try?

It depends almost entirely on which of these you are.

Try it if you already want to live in a terminal and a tiling WM, and the thing stopping you is the two weekends of config work. That is precisely the cost Omarchy eliminates. You get someone's finished, coherent, actively maintained setup instead of your own half-finished one, and you can read the shell scripts to understand every decision it made.

Try it if you want a reproducible dev machine image. The unattended install path is the most underrated feature here. A pinned ISO plus a config drive gets you identical, encrypted, fully-provisioned workstations across a team.

Skip it if you need Secure Boot, need an LTS release cadence, or do work that is fundamentally mouse-driven and GUI-heavy. Skip it if you enjoy building your own environment, because Omarchy's entire value proposition is taking that job away from you.

---

Repo: github.com/basecamp/omarchy