Skip to content

Omarchy

A Linux distribution with a polished, opinionated desktop setup, built by DHH.

Stars
46.1k
Forks
5.8k
Licence
MIT
Language
Shell
Last update
4 days ago
Type
Other

What it is

Omarchy is a Linux distribution, meaning a complete operating system, that comes preconfigured with a specific look, theme system, and set of tools. The README describes it as beautiful, fun, and agentic, and points to a manual covering topics like themes, hotkeys, the terminal, Neovim, AI tools, networking, and updates. The README does not spell out in detail why people choose it beyond these opinionated defaults.

  • Installing a complete Linux desktop with a preconfigured theme and hotkeys
  • Using the built-in Omarchy CLI to manage the system
  • Customizing themes, fonts, backgrounds, and the prompt through the documented config areas
  • Setting up a dual-boot install or running Omarchy in a Windows VM, per the manual sections

Great for

  • Linux users who want a ready-made, opinionated desktop instead of assembling one
  • People coming from Mac or Windows, since the manual has a dedicated guide for that transition
  • Developers who want a preset terminal, Neovim, and shell tooling setup
  • Users interested in customizing themes and configuration on top of a curated base

Not ideal for

  • People who want full control over every package and default; the distribution makes many choices for you
  • Users with hardware that may not be supported; the README mentions Mac support and hardware authentication but does not detail compatibility here
  • Anyone looking for a lightweight install on an existing system; this is a full operating system
Step-by-step guide: how to use OmarchyInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    See the README

    Clone the repository

    git clone https://github.com/omacom/omarchy
  2. 2

    Run it

    • Read the Getting Started page in the manual at manual/02-getting-started.md
    • Check the Dual Boot Install or Unattended Installs pages if those fit your setup
    • Follow the install process described in the manual before booting into the system
  3. 3

    Get the most out of it

    • Read the Hotkeys and Themes sections to learn the core interface
    • Use the Omarchy CLI page to script common system tasks
    • Explore the Dotfiles and Making your own theme pages to customize the setup
    • Review the Updates page to keep the system current

Downloads

Strengths

  • Comes with a coherent, preconfigured desktop, with a manual organized by topic
  • Has an extensive manual that is stated to be the authoritative source
  • Released under the permissive MIT License

Trade-offs

  • The README is truncated and gives few concrete installation details, so the setup path is unclear from this text alone
  • Being opinionated means its defaults may not suit every workflow
  • Requires installing an entire operating system rather than adding to an existing one

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.