Getting Started

Bootstrap a fresh Omarchy machine and run the ongoing dotfiles workflow.

The dotfiles are designed to bootstrap a fresh Omarchy machine and then keep it in sync with a single command. Start with the install guide, then use the checklist for a clean walkthrough.

Install

Prerequisites, bootstrap build, and the ongoing workflow.

New Machine Checklist

A numbered, end-to-end setup for a new machine.

How it fits together

Public dotfiles live at ~/.config/dotfiles and are applied with GNU Stow.
Optional private dotfiles at ~/.config/dotfiles-private overlay machine-specific config.
The dot binary owns setup (dot init), ongoing sync (dot update), and day-to-day tooling.