explaingit

basecamp/omarchy

Analysis updated 2026-05-18

★ 22,569ShellAudience · generalComplexity · 3/5LicenseSetup · hard

TLDR

A Linux distribution with opinionated, pre-configured desktop setup and tools created by DHH, designed for a polished out-of-the-box experience.

Mindmap

mindmap
  root((Omarchy))
    What it does
      Linux distribution
      Pre-configured desktop
      Opinionated setup
    Key features
      Shell scripts
      Curated tools
      Aesthetic design
    Use cases
      Ready-to-use Linux
      Avoid configuration
      Consistent workflow
    Audience
      Linux enthusiasts
      Productivity-focused
      Non-technical users
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up a Linux desktop with pre-made design and tool choices without manual configuration.

USE CASE 2

Get a cohesive, polished Linux environment that works well out of the box for daily use.

USE CASE 3

Run a Linux system with a specific aesthetic and workflow philosophy already baked in.

What is it built with?

ShellLinux

How does it compare?

basecamp/omarchyzsh-users/zsh-syntax-highlightingkholia/osx-kvm
Stars22,56922,59523,257
LanguageShellShellShell
Setup difficultyhardeasyhard
Complexity3/51/54/5
Audiencegeneralops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires installing/booting a full Linux distribution from ISO, which involves partitioning, hardware compatibility checks, and system configuration.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

Omarchy is a Linux distribution created by DHH, the founder of Basecamp and Ruby on Rails, that takes a strong, opinionated stance on how a Linux desktop should look and work. A Linux distribution is a packaged version of the Linux operating system that comes with a specific set of applications, settings, and visual design choices already made for you. The word "opinionated" here means the creator has made deliberate choices about the desktop environment, tools, and workflows rather than offering endless configuration options. The goal is a polished, coherent experience out of the box. The repository contains Shell scripts that set up and configure this environment. Beyond that, details are sparse in the README, which simply points to the project's website for more information. You would look at Omarchy if you are interested in running Linux and prefer a curated, pre-configured setup with a particular aesthetic rather than assembling your own environment from scratch.

Copy-paste prompts

Prompt 1
How do I install and set up Omarchy on my machine?
Prompt 2
What applications and tools come pre-configured in Omarchy?
Prompt 3
Show me the Shell scripts that configure the Omarchy desktop environment.
Prompt 4
How does Omarchy differ from other Linux distributions in terms of default setup?

Frequently asked questions

What is omarchy?

A Linux distribution with opinionated, pre-configured desktop setup and tools created by DHH, designed for a polished out-of-the-box experience.

What language is omarchy written in?

Mainly Shell. The stack also includes Shell, Linux.

What license does omarchy use?

Use freely for any purpose including commercial, as long as you keep the copyright notice.

How hard is omarchy to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is omarchy for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub basecamp on gitmyhub

Verify against the repo before relying on details.

Alternatives & similar repos