Omarchy: DHH's Opinionated Linux Distro
/omarchy
Omarchy Linux is a polished, opinionated desktop for developers who share DHH's preferences. The Arch base is solid and the Neovim config alone saves real hours of setup. It won't work if you want different defaults, but if you want a Linux that thinks like a Rails developer out of the box, the answer is yes.
What is Omarchy?
Omarchy Linux is a modern, opinionated Linux distribution created by DHH of Basecamp and Ruby on Rails fame. Built on Arch Linux, it pre-configures Neovim, terminal tools, GUI applications, AI integration, and a theme system into a cohesive desktop designed around one developer's workflow โ not a lowest-common-denominator Linux.
What's included out of the box
- โArch-based rolling release with a full Neovim configuration including language servers and opinionated keybindings
- โA CLI tool (omarchy) for managing the system, plus shell functions and TUI utilities for common tasks
- โUnified clipboard and history, text extraction, dictation, screenshot and recording tools all integrated
- โGUI applications, commercial software support, and web apps documented with install instructions
- โDeep theming system with included themes, a custom theme guide, and a dedicated CLI branding system
- โSystem snapshots, security hardening, and dual boot or unattended install documentation for production setups
Is Omarchy right for you?
Developers already bought into the DHH toolchain and philosophy will find the most value here. Everyone else should read the manual before committing โ this is a specific aesthetic, not a general-purpose distro.
Strengths
- โAn opinionated system built around DHH's preferences means zero configuration for most choices โ you inherit a coherent workflow rather than assembling one from scratch.
- โThe 52-chapter manual is unusually thorough, covering everything from hotkeys and themes to Windows VM support, dual-boot installs, and making your own theme โ a single canonical source rather than scattered wiki pages.
- โThe bundled omarchy CLI wraps common system tasks, so day-to-day management stays inside a consistent tool rather than requiring raw shell commands or hunting for system settings.
- โCaters to a specific audience well: developers coming from Mac or Windows get guided setup, while Linux veterans get sensible defaults for terminal, Neovim, and development toolchains.
Omarchy's trade-offs
- โณThe opinionated approach means fighting the defaults if your preferences diverge from DHH's โ there's no gentle ramp from neutral to customized.
- โณInstall documentation assumes Arch knowledge and doesn't provide a quick-start script for newcomers.
- โณThe entire value proposition depends on agreeing with the choices made โ if you prefer a different Neovim config or window manager, you're rebuilding from scratch anyway.
- โณA manual-heavy system means navigating documentation rather than following a UI wizard โ less accessible for users who prefer guided setup.
How Omarchy compares to other Linux distros
Frequently asked questions
Yes. Omarchy is released under the MIT License and all source code is on GitHub at basecamp/omarchy.
The manual has dedicated chapters for users coming from macOS and from Windows, covering navigation and workflow differences.
Omarchy doesn't use a standard desktop environment โ it layers a custom window manager and top bar on top of Arch with its own themes and hotkeys.
Yes. The manual has a Gaming chapter and a section on Windows VMs, and Steam is documented as a supported commercial application.
Omarchy relies on Arch's rolling-release model. The manual covers how updates work, what the upgrade process looks like, and what to watch for.
Yes. The manual documents both dual boot installs and unattended install workflows designed for multi-OS environments.
The problem it solves
Every time you set up a new Linux machine you spend hours configuring Neovim, shell tooling, GUI apps, and system preferences โ and every decision you make forks into more setup. Omarchy makes that curation explicit and opinionated so you get a working desktop immediately.
Best use cases
- โขDevelopers who have already settled on DHH's tooling preferences and want a Linux desktop that matches that workflow out of the box.
- โขDevelopers who run Arch and want a curated shell, dotfiles, and GUI defaults without spending days assembling them manually.
- โขIT teams needing a reproducible Linux setup with unattended installs and dual boot documentation for enterprise environments.
How to install / try
Not clearly documented as a single script โ the repository is the source but the install process isn't front-and-center. The manual covers both standard and unattended install paths, and assumes you're comfortable with Arch basics.
Related repositories
Curious whether omarchy is right for you?
Let ChatGPT, Claude, or Perplexity look into it โ click below and see what AI actually says about omarchy.