Personal Arch Linux from the Creator of Ruby on Rails

David Heinemeier Hansson (DHH) spent many years developing software exclusively on MacBooks. Last year, he suddenly switched from macOS to Arch Linux, moved to a powerful desktop, and began openly criticizing closed platforms. Most programmers would have stopped there, setting up a couple of standard tiling configs. DHH went further. He assembled his personal setup into a distribution called Omarchy.

The repository garnered tens of thousands of stars within weeks. Inside you'll find detailed documentation, system scripts, tiling, local neural networks, and even instructions for filling out PDF forms.

What is Omarchy

Essentially, this is a custom Arch Linux build. Everything comes pre-configured—fonts, color themes, shortcuts, and regular backups. The main idea behind the project is simple. A developer avoids two weeks of reading ArchWiki just to handle mundane tasks like enabling Bluetooth, setting up audio via PipeWire, or adjusting monitor brightness.

At the same time, Omarchy doesn't try to please everyone. It's an ultimatively subjective system. The author chose a specific terminal, editor, shell, and window layout. Either you accept these rules of the game, or you spend hours rewriting someone else's scripts to match your habits.

The distribution has no dozens of dialog boxes asking you to choose components during installation. The script installs a ready-made set of programs that DHH considers optimal for daily coding, testing web applications, and managing servers.

What's inside this build

Terminal and code tools

The foundation of the workspace is Neovim with a refined set of plugins, syntax highlighting, and LSP support. Helper TUI utilities, shell functions, and clients for communicating with language models come pre-installed for coding work. You open the terminal and start writing code immediately without manually building your environment first.

The shell comes equipped with a custom prompt, plugins for command autocompletion, and quick directory navigation. If you need to check system logs or monitor CPU usage, modern console utilities are at your fingertips instead of outdated standard Unix commands.

Utilities for everyday routine

When switching from commercial operating systems to Linux, small interface rough edges are the most frustrating. Omarchy pre-emptively addresses four common issues:

• built-in clipboard manager with quick history search;
• optical text recognition from a selected screen area;
• voice dictation via local Whisper model;
• unified system notifications and reminders center.

All these features are bound to global keyboard shortcuts. Text recognition works instantly: you press a hotkey, select an image or video fragment, and the text immediately drops into the clipboard. Local dictation doesn't send your voice to external servers, so your data stays on disk.

Graphics, games, and everyday tasks

An engineer doesn't spend every waking hour exclusively in a terminal window. The build accounts for typical user scenarios:

• running modern games via Steam and Proton;
• separate Windows virtual machine for rare closed-source software;
• launching web apps in isolated browser windows;
• tools for filling out and signing documents.

You won't need to find workarounds for signing contracts or wonder how to set up GPU passthrough to a virtual machine. Answers to these questions are already laid out in the corresponding documentation chapters.

Management via custom CLI

A utility called omarchy was written for updating components and switching system parameters. It lets you apply fresh patches, change visual themes, configure system snapshots, and check hardware status.

The CLI utility handles the routine of syncing dotfiles, checking package integrity, and configuring the appearance of workspaces.

How the repository is structured under the hood

The project structure is refreshingly straightforward. There are no heavy graphical installers. All logic is built on shell scripts, configuration files, and a detailed guide in the manual/ directory.

Documentation is split into fifty chapters. Each step is explained sequentially. The manual covers monitor arrangement nuances, sleep mode configuration, YubiKey hardware security key connection, and installing alongside Windows.

Installation scripts download packages from official Arch and AUR repositories, place dotfiles throughout the home directory, and activate the necessary systemd services. btrfs filesystem snapshots are used for failure protection. If a nightly update breaks something, you can roll back to a working point in a couple of seconds directly from the boot menu.

Who this setup is for

If you've long wanted to try a tiling window manager and Arch Linux but were intimidated by the prospect of building the system manually, Omarchy makes an excellent starting point. You get a refined environment where someone spent hundreds of hours tweaking indentation, fonts, and hotkeys.

The second obvious scenario is migrating from Mac. The guide has a separate chapter for those accustomed to Apple keyboard shortcuts. The build strives to recreate that feeling of a finished workspace that minimalist Linux distributions often lack.

Automated scripts also come in handy for those who frequently reinstall systems on new laptops or workstations. Deploying a ready-made environment takes minimum time.

Pitfalls and limitations

The main downside of the project is directly tied to its authored nature. DHH created the distribution strictly for his own needs. It uses a specific browser, Neovim instead of familiar heavy IDEs, and a specific window management logic. You can rework basic things, but in that case it's easier to build your own configuration from scratch.

Additionally, the Arch Linux base requires regular attention to updates. Omarchy scripts automate routine tasks, but you'll need basic terminal skills and an understanding of the pacman package manager at the first sign of an unscheduled dependency situation.

Is it worth trying

Omarchy turned out to be a cohesive project with its own philosophy. It's not a universal distribution for everyone, but a ready-made digital workbench for a web developer.

If minimalism and terminal interfaces appeal to you, the project is definitely worth testing personally. The easiest way is to deploy the system on a spare SSD or test machine, walk through the guide, and evaluate how well this approach to organizing your workspace suits you.