Configuration Highlights

Omarchy’s Configuration Highlights section outlines the key system settings and defaults that Omarchy applies during installation. These configurations ensure a consistent, optimized environment tailored for an Arch Linux → Hyprland desktop experience.

Index

Pacman Configuration

Omarchy’s Pacman Configuration takes place in the preflight phase of the installer. It ensures that the system has essential build tools, applies Omarchy’s curated package manager settings, and adds the Omarchy repository for custom packages.

Preflight Script

Location: install/preflight/pacman.sh
This script performs four core steps:

Step Description Reference
1. Install build tools Installs base-devel for compiling AUR and source packages. sudo pacman -S --needed --noconfirm base-devel
2. Apply pacman.conf Copies Omarchy’s default pacman.conf to /etc/pacman.conf. sudo cp -f ~/.local/share/omarchy/default/pacman/pacman.conf /etc/pacman.conf
3. Apply mirrorlist Copies Omarchy’s curated mirror list to /etc/pacman.d/mirrorlist. sudo cp -f ~/.local/share/omarchy/default/pacman/mirrorlist /etc/pacman.d/mirrorlist
4. Refresh all repositories Runs a full system sync and upgrade to register new settings. sudo pacman -Syu --noconfirm 
#!/bin/bash
# Install build tools
sudo pacman -S --needed --noconfirm base-devel

# Configure pacman
sudo cp -f ~/.local/share/omarchy/default/pacman/pacman.conf /etc/pacman.conf
sudo cp -f ~/.local/share/omarchy/default/pacman/mirrorlist /etc/pacman.d/mirrorlist

# Refresh all repos
sudo pacman -Syu --noconfirm

Default pacman.conf Settings

Omarchy ships with its own pacman.conf under default/pacman/pacman.conf. This file defines improved defaults for speed, verbosity, and adds an [omarchy] repository.

# default/pacman/pacman.conf
[options]
Color
ILoveCandy
VerbosePkgLists
HoldPkg      = pacman glibc
Architecture = auto
CheckSpace
ParallelDownloads = 5
DownloadUser       = alpm

SigLevel = Required DatabaseOptionalLocalFile
SigLevel = Optional

[core]
Include = /etc/pacman.d/mirrorlist

[extra]
Include = /etc/pacman.d/mirrorlist

# [multilib]
# Include = /etc/pacman.d/mirrorlist

[omarchy]
SigLevel = Optional TrustAll
Server   = https://pkgs.omarchy.org/$arch

Key Directives

  • Color
    Enables colored output for clearer package management feedback.
  • ILoveCandy
    Adds fun Pacman animations during operations.
  • VerbosePkgLists
    Always shows full lists of packages to be installed, upgraded, or removed.
  • ParallelDownloads = 5
    Speeds up updates by downloading up to five packages simultaneously.
  • DownloadUser = alpm
    Runs downloads under the ALPM user for better permission isolation.
  • HoldPkg
    Prevents critical packages (pacman, glibc) from being accidentally removed.
  • [omarchy] Repository
    Provides Omarchy-specific packages and themes.

Default Mirrorlist

Omarchy provides a tailored mirror selection in default/pacman/mirrorlist, balancing speed and reliability:

# default/pacman/mirrorlist
Server = https://mirror.omarchy.org/$repo/os/$arch
Server = https://mirror.rackspace.com/archlinux/$repo/os/$arch
Server = https://geo.mirror.pkgbuild.com/$repo/os/$arch

Workflow Diagram

flowchart TD
    A([Start Installer]) --> B[Run preflight scripts]
    B --> C[Install base-devel]
    B --> D[Copy Omarchy pacman.conf]
    B --> E[Copy Omarchy mirrorlist]
    B --> F[Refresh repositories]
    F --> G([Proceed to Package Installation])

This flow ensures that, before any package installation, your system is pre-configured for optimal speed, visibility, and access to Omarchy’s curated software.