Install
Omarchy Quattro · v4.0.0 has been released → 
                 ▄▄▄
 ▄█████▄    ▄███████████▄    ▄███████   ▄███████   ▄███████   ▄█   █▄    ▄█   █▄
███   ███  ███   ███   ███  ███   ███  ███   ███  ███   ███  ███   ███  ███   ███
███   ███  ███   ███   ███  ███   ███  ███   ███  ███   █▀   ███   ███  ███   ███
███   ███  ███   ███   ███ ▄███▄▄▄███ ▄███▄▄▄██▀  ███       ▄███▄▄▄███▄ ███▄▄▄███
███   ███  ███   ███   ███ ▀███▀▀▀███ ▀███▀▀▀▀    ███      ▀▀███▀▀▀███  ▀▀▀▀▀▀███
███   ███  ███   ███   ███  ███   ███ ██████████  ███   █▄   ███   ███  ▄██   ███
███   ███  ███   ███   ███  ███   ███  ███   ███  ███   ███  ███   ███  ███   ███
 ▀█████▀    ▀█   ███   █▀   ███   █▀   ███   ███  ███████▀   ███   █▀    ▀█████▀
                                       ███   █▀

Beautiful, modern & opinionated Linux.
Ready on the first boot.

One ISO turns a fresh machine into a fully-tuned Arch + Hyprland development system — tiling windows, curated tools, twenty-two themes, and defaults worth arguing about. By DHH. No ricing required.

↓ Download the ISO Read the Manual ★ 26k on GitHub

This page is keyboard-driven too — press ? for hotkeys.

omarchy-install — 96×28

The actual installer show — simulated here, ~47 seconds on a fast machine in real life.

scroll

1 philosophy

Omakase, not
assembly required.

“A beautiful system is a motivating system, and productivity has always been downstream from motivation.”

— The Omarchy Manual

Omarchy is an omakase Linux distribution — Arch underneath, Hyprland on top, and a chef (DHH) who has already decided what’s for dinner. Every default has been argued about so you never have to. It’s not trying to be as familiar as possible. It’s trying to be beautiful and better.

This isn’t a grab bag of preinstalled packages. It’s a complete system designed with both aesthetics and productivity in mind — from Neovim (btw) to Chromium, Obsidian to LibreOffice, Kdenlive to OBS Studio. Hell, even a retro Winamp-style music player is there.

There’s zero bloat here: just everything he uses.

2 the stack

Everything you need.
Nothing you don’t.

Shown, not just listed — the actual tools that greet you on first boot.

window manager

Hyprland, tamed

Dynamic tiling with dwindle and scrolling layouts, buttery animations, grouped windows, scratchpads, and per-workspace everything. The window manager that makes floating desktops feel quaint.

shell

Quickshell desktop

Top bar, menus, notifications, OSD and lock screen — one coherent shell. Drag widgets, edit shell.json, own your bar.

editor

Neovim (btw)

LazyVim out of the box: LSPs, treesitter, fuzzy find with SpaceSpace, git controls on SpaceGG. VSCode, Zed, Cursor & Helix a menu away — theme-matched.

terminal

Pick your poison

Alacritty, Ghostty, Kitty or Foot — all pre-themed, all wired to Super+Return. Tmux and Herdr keep sessions immortal; Starship keeps the prompt honest.

tui toolbox

Terminal power tools

Lazygit for git, Lazydocker for containers, btop as Activity (Super+Ctrl+T), fzf, zoxide, ripgrep, eza, fastfetch. The good stuff, pre-configured.

ai-native

Agents, first-class

Claude, Codex, OpenCode, Gemini & friends pre-wired as lazy mise stubs. tdl c splits an IDE: editor left, agent right, terminal below. They even follow your theme.

gui staples

Real apps too

Chromium, Obsidian, Omawrite, LibreOffice, Nautilus, Pinta, Kdenlive, OBS Studio, LocalSend for AirDrop-style sharing. Double-click sanity included.

dev environments

Runtimes on rails

Ruby on Rails (of course), Node, Bun, Deno, Go, Rust, Python, Elixir, PHP, .NET, Zig — all mise-managed. Docker + Compose ready, databases one menu away.

play

Even gaming

Steam with Proton, RetroArch preconfigured with the CRT Royale shader, Lutris, Heroic, Battle.net, Moonlight, and Minecraft. The Steam Deck runs Arch — so do you now.

safe by default

Encrypted & undoable

Full-disk LUKS encryption is the default, not an option buried in a wizard. System snapshots mean every experiment has an undo button. Lost laptop ≠ lost data.

3 themes

Twenty-two themes.
One keystroke apart.

Each theme restyles the desktop, terminal, Neovim, btop, Chromium, the bar, menus, notifications, the OSD and the lock screen. Pick one below — it restyles this entire page too.

desktop — tokyo-night
Omarchy desktop in the Tokyo Night theme

Tokyo Night

The default. Neon-soaked late-night hacking energy.

    $ omarchy-theme-set tokyo-night

    Super+Ctrl+Shift+Space on the real system · T cycles themes here

    4 install

    From bare metal to
    beautiful in minutes.

    Five steps. No wiki spelunking, no dotfile archaeology, no rice.

    1. 1

      Download the ISO

      Grab the latest Omarchy image — Quattro, v4.0.0.

      wget https://iso.omarchy.org/omarchy-4.0.0.iso
    2. 2

      Flash a USB stick

      balenaEtcher on Mac/Windows, or caligula on Linux. Any stick from the last decade will do.

      caligula burn omarchy-4.0.0.iso
    3. 3

      Boot it — Secure Boot off

      Disable Secure Boot and TPM in the BIOS first; they’re Microsoft schemes the installer can’t boot through. Then boot off the stick.

    4. 4

      Answer five questions

      Keyboard layout, name, email, username, password. Pick a drive — full-disk, or the free space beside Windows for a dual boot. Encryption is on by default.

      Setting it up for someone else? Ctrl+C on the first screen defers all personal setup to their first boot.

    5. 5

      Watch the show

      Under a minute on a fast machine, never more than five. Reboot, type your passphrase, and Tokyo Night greets you with everything already running.

      ✔ Welcome to Omarchy.

    ⌨ Use a wired or 2.4GHz keyboard

    Full-disk encryption can’t hear Bluetooth at boot — same as your BIOS. A cable is nicer for latency anyway. DHH types on a Lofree Flow84.

    ▦ Dual boot friendly

    The free-space install slots Omarchy into unallocated drive space, so it lives happily next to Windows. (Turn BitLocker off first.)

    ⚙ Unattended & fleet-ready

    Hand the ISO its config on a second drive and it installs with zero keyboard — a base image for VMs and fleet machines.

    5 hotkeys

    Your mouse is
    about to retire.

    The greatest hits, straight from the manual. On the real system, Super+K shows every binding, any time.

    Navigating

    • SuperSpaceOmarchy menu — apps and everything else
    • SuperReturnTerminal
    • Super1–4Jump to workspace
    • Super←→↑↓Move focus between windows
    • SuperTTile ↔ float a window
    • SuperFFull screen
    • SuperWClose window
    • AltTabCycle windows on the workspace

    System

    • SuperEscSystem menu — suspend, restart, power
    • SuperCtrlLLock computer
    • SuperCtrlAAudio panel
    • SuperCtrlWWi-Fi & network panel
    • SuperCtrlBBluetooth panel
    • SuperCtrlTActivity (btop)
    • SuperCtrlQCalculator
    • SuperCtrlEEmoji picker

    Capture & share

    • SuperCtrlCScreenshot, recording & color picker
    • SuperCtrlSShare menu via LocalSend
    • SuperCtrlShiftSpaceTheme selector
    • SuperCtrlSpaceNext background in the theme
    • SuperShiftDLazydocker
    • SuperShiftCtrlAPick an AI agent
    • SuperAltReturnTmux session “Work”
    • SuperSScratchpad overlay
    1ISO to rule it all
    22themes included
    <5minworst-case install
    26kGitHub stars
    0bloat, dollars, telemetry
    MITlicensed, fork away

    6 onward

    Pick your path.

    ↓

    Download the ISO

    omarchy-4.0.0.iso — the whole omakase on a stick.

    install →     ▤

    Read the Manual

    Short, opinionated, and genuinely fun. Teaches the why.

    omarchy.org/manual →     ★

    Source on GitHub

    Every default in the open. MIT licensed — fork the chef.

    basecamp/omarchy →     ✦

    Join the Discord

    Stuck? #omarchy-help is full of people who’ve been there.

    discord.gg →     ▣

    Workstations

    See the rigs Omarchy runs on — from Frameworks to battlestations.

    workstations →     ▲

    Merch

    Wear the tiling-window religion on your sleeve.

    supply.37signals.com →
    View more demos Get $10 off Kimi K3