Skip to content

dotfiles

Personal dotfiles for macOS, Debian/Ubuntu-family Linux (PikaOS, etc.), Arch Linux, Fedora, openSUSE, and Bazzite. Managed with chezmoi: this repo is chezmoi's source directory, applied on top of $HOME rather than symlinked or checked out directly onto it.

Quickstart

1. Bootstrap — installs chezmoi itself, then has chezmoi clone this repo as its source directory and apply it onto $HOME. Safe to run on a machine that already has its own default .zshrc/.zprofile/etc.: anything that would conflict with the apply is moved to ~/.dotfiles-backup first instead of being overwritten.

curl -fsSL https://raw.githubusercontent.com/jonstump/dotfiles/main/bootstrap.sh | bash

Only curl is required up front — the script installs git itself if it's missing (day-to-day usage wants a real git, even though chezmoi can clone without one). On macOS that means kicking off the Xcode Command Line Tools install (git ships with them); accept the dialog, let it finish, then re-run the same command. On Linux it installs git via apt-get/dnf/pacman/zypper. chezmoi itself is installed via its official install script into ~/.local/bin, on both platforms — no brew/apt package needed.

2. Install tooling — open a new shell, then run the OS-detecting installer that was just applied:

$(chezmoi source-path)/../install.sh

install.sh is safe to re-run; every step checks whether its target already exists before doing anything.

Per-distro install details: macOS · Debian/Ubuntu · Arch · Fedora · openSUSE · Bazzite

Documentation