Omarchy - User docs

Ask about this space

Ask questions and get answers from this public documentation.
  • Start Here: Requirements and Installation
    3
    • Requirements and Installation
    • System requirements (must pass preflight)
    • Bootstrap and run the installer
  • Daily Use: Updates, Themes, Apps, and Screen Tools
    4
    • Manage and apply themes
    • Update Omarchy and your system
    • Install common apps quickly
    • Screen recording tools
  • Configuration Highlights (what Omarchy configures)
    6
    • Keyboard layout in Hyprland
    • Docker daemon and DNS
    • Pacman configuration
    • Git defaults and identity
    • Auto-login and Plymouth splash
    • Theming in apps (Alacritty, Chromium, GTK/icons)
  • How the Installer Works (end-to-end flow)
    6
    • Orchestrator: install.sh
    • Preflight checks and environment prep
    • Finishing and reboot
    • Login setup
    • Configuration modules
    • Packaging modules
  • Migrations and Update Pipeline
    2
    • Migration runner behaviour
    • Examples of migrations you may see
  • Project Layout (where things live)
    5
    • bin/ — CLI utilities
    • install/ — installer modules
    • migrations/ — one-time update scripts
    • config/ — default app and desktop configs
    • Branding assets
  • Troubleshooting and Recovery
    3
    • Installing in chroot environments
    • If the installer fails
    • When a reboot or relaunch is required

Powered by

On this page

​