Skip to content
Dotfiles logo Dotfiles

New Machine Checklist

A clean, end-to-end walkthrough for setting up a new machine.

  1. Clone dotfiles to ~/.config/dotfiles.
  2. If you want private dotfiles, confirm gh auth status works before dot init; init clones dotfiles-private to ~/.config/dotfiles-private automatically when auth is available.
  3. Install bootstrap build prerequisites:
    Terminal window
    sudo pacman -S --needed git mise
  4. Build the dot binary:
    Terminal window
    cd ~/.config/dotfiles/dot
    mise --no-config exec bun@latest -- bun install
    mise --no-config exec bun@latest -- bun run build
  5. Run first-use setup:
    • Desktop / VM: ~/.config/dotfiles/scripts/.local/bin/dot init --noninteractive --confirm
    • Laptop: dot init --host laptop --noninteractive --confirm
    • Interactive: dot init in an interactive shell
  6. If stock Omarchy config directories already exist at ~/.config/waybar, ~/.config/ghostty, or ~/.config/uwsm, dot init backs them up with a .dot-init-backup-* suffix before cloning the managed repos. Hyprland config is stowed from the hypr/ package instead.
  7. Restart your shell and confirm dot help is on PATH.
  8. Run dot git-diff and verify the expected repo state.
  9. Run dot update for ongoing sync, stow, rebuild, and init-state backfill.