What Is Omarchy? The Beginner's Guide to DHH's Omakase Linux Distro (Arch + Hyprland, Explained)

CodexFuse Team · 2026-11-04T13:44:17.153Z · 13 min read min read

What Is Omarchy? The Beginner's Guide to DHH's Omakase Linux Distro (Arch + Hyprland, Explained)

If you have been hearing developers talk about Omarchy and wondering what is Omarchy, exactly — this is omarchy explained for beginners. Omarchy is a Linux distribution created by David Heinemeier Hansson (DHH), the creator of Ruby on Rails, that takes Arch Linux and the Hyprland tiling window manager and turns them into a finished, keyboard-first developer desktop you can install in minutes. It launched in June 2025, rewrote its whole desktop shell for the 4.0 "Quattro" release in August 2026, and is now stewarded by its own nonprofit, the Omacom Foundation. This guide covers what it is, how the omakase philosophy works, what is new in 4.0, and who it is for.

Unlike a server distribution, Omarchy is built for the machine on your own desk — the one you sit in front of every day. (If you also keep remote Linux boxes running, our VPS hosting guide covers that side of a developer's setup.)

What Is Omarchy, Exactly?

Omarchy is an opinionated Linux distribution built on Arch Linux and the Hyprland tiling window manager, created by DHH and designed to hand you a complete, beautiful, keyboard-driven developer desktop out of the box. The project's own GitHub README describes it as "a beautiful, fun & agentic Linux distribution by DHH," and the current Omarchy manual defines it as "an omakase Linux distribution based on Arch, the tiling window manager Hyprland, and the desktop construction-kit Quickshell."

The key word in that definition is opinionated: instead of giving you a blank system and a wiki, Omarchy ships strong, curated defaults — the desktop theme, the keybindings, the launcher, the terminal, the editor — all decided for you, all changeable. As of this writing the GitHub repository (omacom/omarchy) carries an MIT license and has gathered more than 46,000 stars, which makes it one of the most-watched Linux desktop projects of the past year.

What Does "Omakase" Mean in Omarchy?

Omakase means "chef's choice" — and in Omarchy it is the whole design philosophy: DHH and his team pick the tools and tune the details, so you can get straight to work instead of spending weekends assembling a desktop. The omarchy.org homepage puts it this way: "Oma is for omakase, chef's choice: we pick the tools and tune the details, so you can get straight to work. But this is your computer. You're free to change everything."

This is not a new idea for DHH. Back in 2012 he wrote "Rails is omakase," arguing that "a team of chefs picked out the ingredients, designed the APIs, and arranged the order of consumption on your behalf according to their idea of what would make for a tasty full-stack framework." The Rails Doctrine still lists "The menu is omakase" as one of its pillars: "How do you know what to order in a restaurant when you don't know what's good? Well, if you let the chef choose, you can probably assume a good meal, even before you know what 'good' is. That is omakase." Omarchy is that same philosophy applied to a desktop operating system — a curated menu you can send back and reorder at will, which is why the project calls itself "the malleable OS for the age of agents."

Who Created Omarchy, and Why?

Omarchy was created by David Heinemeier Hansson — DHH — the creator of Ruby on Rails and co-founder of the software company 37signals, and it was his attempt to solve a very specific frustration. In his launch post "Omarchy is out," he called it "my latest love letter to Linux... an opinionated setup of the Arch Linux distribution and the Hyprland tiling window manager. With everything configured out-of-the-box to give you exactly the same setup that I now run every day. My Platonic ideal of what a developer environment should look like."

The problem he was solving was real: Hyprland is a superb tiling compositor, but as DHH put it, "it comes incredibly bare-boned in the box. You have to figure out everything yourself. Even how to get a lock screen or idle timing or a menu bar or bluetooth setting or... you get the idea." So he wrote the defaults himself: "Omarchy is an attempt to solve for all that. To give you a default set of great, beautiful configurations for Hyprland, and installing all the common tooling you'd normally want. You could setup this, not change a thing, and you'll have exactly what I run every day."

A bit of history helps here. Omarchy began life in June 2025 as a setup script you ran on top of an existing Arch install; Wikipedia records its initial release as June 26, 2025. It is a sister project to Omakub, DHH's earlier opinionated setup for Ubuntu from June 2024 — and DHH has been explicit that Omarchy is not a replacement for Omakub, just the Arch-flavored sibling. He also warns upfront: "It's not for everyone." The project was incubated at 37signals and is now run by its own foundation.

What Is Omarchy Made Of? The Three Layers

Omarchy stacks exactly three pieces, and understanding each one explains the whole system. Arch Linux sits at the base and provides the rolling-release engine — pacman packages, the AUR, always-current software. Hyprland sits in the middle as the tiling Wayland compositor, arranging your windows in a grid you drive with the keyboard. And since version 4.0, a Quickshell-built desktop shell sits on top, drawing the bar, the launcher, the menus, and the notifications.

Everything in that stack is configured with plain-text files that belong to you — the same dotfiles workflow that our Git beginner guide walks through, if you want to version-control your setup like code.

What's New in Omarchy 4.0 "Quattro"?

Omarchy 4.0 — codenamed Quattro, released August 14, 2026 — is the biggest release in the project's history: a full rewrite of the desktop shell in Quickshell. The bar, launcher, menus, notifications, on-screen displays, control panels, lock screen, and polkit agent now all live inside a single long-running shell process with a plugin architecture, replacing a patchwork of separate tools: Waybar, Walker, Mako, SwayOSD, hyprlock, hypridle, swaybg, and polkit-gnome.

The release also leaned hard into the "agentic" half of the project's tagline. Quattro pre-wires nine coding-agent CLIs — including Claude Code, Codex, OpenCode, Gemini, Grok, and Copilot — as lazy-loaded launchers, and on first boot you pick a default coding agent. The ISO shrank to under 6 GB (more than a gigabyte smaller than the 3.x line), the project's internals moved into proper Arch packages installed at /etc and /usr/share/omarchy with updates flowing through pacman, and the GitHub repository moved from basecamp/omarchy to omacom/omarchy with the default branch renamed "quattro."

The numbers behind the release were striking. Within the project the release is usually just called Omarchy Quattro, and it passed 100,000 ISO downloads in its first week and 200,000 by September 2; DHH later said it passed 300,000 downloads in its first month, and the total has since crossed a million. A 4.0.5 fix release followed on October 17–18, 2026.

Omarchy vs Arch: What's the Difference?

Plain Arch hands you a blank system and a wiki; Omarchy hands you DHH's finished desktop on top of that same Arch base. The engine underneath is identical — rolling packages, pacman, the AUR — but everything above it is pre-decided, pre-themed, and pre-wired.

That is the honest tradeoff. If configuring every pixel yourself is the hobby, plain Arch is the hobby. If you want the Arch engine with a finished, keyboard-driven desktop on day one, that is the gap Omarchy fills.

How Keyboard-First Is the Omarchy Workflow?

Completely — Omarchy is a keyboard-first desktop through and through. Windows share the screen in a tiled grid, the Super key (the Windows key on most keyboards) conducts the whole desktop, one menu on Super + Space is the front door to everything, and there is no dock and no desktop icons. The theme system restyles the entire desktop at once, so the bar, the launcher, and the windows all match.

That keyboard-first design assumes you are comfortable in a terminal, because Omarchy expects you to live in one — the whole point of the pre-tuned Omarchy Hyprland desktop is that you rarely reach for the mouse. If you are still building shell muscle memory, our AI bash command generator can turn plain English into the commands you need while you learn. And if you want to take the keyboard-first idea even further — remapping keys at the system level, beneath any desktop — our keyd beginner guide walks through the keyd daemon that does exactly that.

How Do You Install Omarchy?

You write the ISO to a USB stick, boot it, and answer five questions — Omarchy says you will be up and running in as little as 35 seconds on the fastest machines, and in less than two minutes on the majority of computers. The whole install arc looks like this:

1. Download the ISO from omarchy.org (the 4.x line ships an ISO under 6 GB).
2. Write it to a USB stick with your usual imaging tool and boot from it.
3. Answer five questions — the installer hands back a finished desktop.
4. Choose full-disk or dual-boot. Installation defaults to full-disk encryption, so your data is protected from the start.
5. Turn off Secure Boot and TPM in your BIOS first, or the installer will not proceed.

Two platform notes: Omarchy targets x86_64 hardware only — there is no official Apple Silicon build — though ARM ISOs are expected in the 4.5 release-candidate pre-release. And if your network misbehaves on first boot, our Linux system guides cover fixes like flushing the DNS cache on Linux.

What Is the Omacom Foundation?

The Omacom Foundation is the US nonprofit DHH set up on August 21, 2026 to steward Omarchy for the long term. Its mandate, in DHH's own words, is to "hold the trademarks, fund the infrastructure, promote the work, and support the open-source projects and developers Omarchy depends on."

The funding story is unusual for a Linux desktop project. The foundation opened with an $8 million seed from eight $1 million patrons: Michael Dell, Jack Dorsey, Patrick Collison, Tobi Lütke, Matthew Prince, Brendan Iribe, Jason Fried, and DHH himself. By August 31 the total had reached $12.6 million as more patrons joined and 1Password and 37signals each pledged $100,000 a year for three years; by mid-October, with additions including $3 million each from DigitalOcean and Alibaba Cloud, total backing stood at roughly $23.7 million.

The foundation has put that money to visible use: it signed an exclusive three-year sponsorship of Hyprland's lead developer Vaxry and a premier sponsorship of Quickshell — the two open-source projects Omarchy's desktop is built on. That matters because it means the stack underneath your Omarchy install has funded maintainers, not just volunteers.

Who Is Omarchy For? (And Who Should Skip It?)

Omarchy is for developers who want a fast, beautiful, keyboard-driven Linux desktop without spending weeks configuring one — and it is not for everyone, by DHH's own admission in the launch post. If you live in a terminal, like tiling window managers, and want AI coding agents wired into your OS, it is aimed squarely at you. It is also pitched at Windows and Mac users who are curious about Linux but do not want to start from a blank Arch install.

Who should skip it? Anyone who needs a different CPU architecture (x86_64 only for now), anyone who wants a point-and-click desktop that mimics Windows or macOS, and anyone running servers — this is a workstation desktop, not a headless OS. And if total configurability is the point of Linux for you rather than the means to an end, the omakase menu may feel like a constraint rather than a gift.

Where Do You Download Omarchy?

For the official omarchy download, head to omarchy.org — the ISO is the only supported install route, and the 4.x line ships as a sub-6 GB image you write to a USB stick. The project's GitHub repository at omacom/omarchy is where the source, the release notes, and the issue tracker live.

One naming note, since you are reading this on CodexFuse: this article is about Omarchy the Linux distribution — not to be confused with a similarly named item on this site, our omarchy-guide, which is a guide to building iOS apps on Linux. Different product entirely; the distro is the subject here.

Sources

Every fact in this guide comes from a page fetched on 2026-11-04:

• Omarchy homepage — https://omarchy.org
• Omarchy manual, "Getting started" — https://omarchy.org/manual/getting-started
• omacom/omarchy on GitHub — https://github.com/omacom/omarchy
• DHH, "Omarchy is out" — https://world.hey.com/dhh/omarchy-is-out-4666dd31
• Wikipedia, "Omarchy" — https://en.wikipedia.org/wiki/Omarchy
• The Rails Doctrine — https://rubyonrails.org/doctrine
• starryhope.com, "What Is Omarchy? How DHH's Arch Desktop Works" — https://starryhope.com/linux/what-is-omarchy/
• codetocloud.io, "Omarchy 4 Quattro: What's New in DHH's Agentic Linux Desktop" — https://codetocloud.io/blog/omarchy-4-quattro-whats-new/
• dev.classmethod.jp, "Trying Omarchy on macOS" — https://dev.classmethod.jp/en/articles/reona-omarchy-try-on-mac/
• daveknowstech.com, "The Things I'd Change About Omarchy" — https://www.daveknowstech.com/2026/09/04/the-things-id-change-about-omarchy/
• notes.nicolasdeville.com, Omarchy notes — https://notes.nicolasdeville.com/apps/omarchy/
• centlinux.com, "Omarchy Linux: A Dev's Dream OS" — https://centlinux.com/omarchy-linux/
• thelinuxlaptop.com, Omarchy laptops — https://thelinuxlaptop.com/omarchy-laptops/
• itsfoss.com, Omarchy AI agent focus — https://itsfoss.com/news/omarchy-ai-agent-focus/
• techaeris.com, Omarchy Foundation opens with $8 million — https://techaeris.com/2026/08/22/omarchy-foundation-opens-with-8-million/

Frequently Asked Questions

Is Omarchy a real Linux distribution, or just someone's dotfiles?

It is a real, if young, distribution — and the distinction is fair to ask about, since critics have called it "essentially Arch Linux plus DHH's dotfiles." The case for "distro": it ships its own ISO, maintains its own mirrored package repository, packages its internals as Arch packages updated through pacman, and is now stewarded by a funded nonprofit foundation. The case for "dotfiles": underneath it all sits Arch Linux, and Omarchy began life as a setup script. Both are true — think of it as an opinionated Arch-based distro, in the same way Ubuntu is an opinionated Debian-based distro.

Is Omarchy free to use?

Yes. Omarchy is MIT-licensed and free, and the project's infrastructure is funded by the Omacom Foundation's patron backing rather than by charging users.

Can I run Omarchy on a Mac or an ARM machine?

Not officially. Omarchy targets x86_64 hardware only — there is no official Apple Silicon build. ARM ISOs are expected in the 4.5 release-candidate pre-release, so if you are on Apple Silicon, that is the version to watch.

What happened to Omakub? Is Omarchy replacing it?

Nothing happened to it — Omakub, DHH's opinionated setup script for Ubuntu from June 2024, still exists. DHH has said explicitly that Omarchy is a sister project to Omakub, not a replacement: Omarchy is the Arch + Hyprland flavor, Omakub is the Ubuntu flavor.

Do I need to know Arch or Hyprland before trying Omarchy?

No — that is the entire point of the omakase approach. The defaults are pre-made by someone who lives in this stack daily, so you can start using the desktop immediately and learn the underlying pieces as you go. Terminal comfort helps, since the workflow is keyboard-first, but prior Arch experience is not required.