dotfiles

Personal dotfiles and customizations.

Installation

Linux

• Install prerequisites:

sudo apt update && sudo apt install --yes git stow

• Create the checkout directory, then clone and install the dotfiles:

mkdir -p ~/projects/_personal
cd ~/projects/_personal

git clone https://github.com/aarondettmann/dotfiles.git

cd dotfiles
./install.sh

# Unattended install
# ./install.sh --yes

• Install software packages:

./other_customs/fresh_install/install_pkgs.sh

• Install Neovim (latest stable release, into ~/.local/opt; also used to update an existing installation):

./scripts/update-nvim.sh

• Restore the GPG and SSH configurations under $HOME.

Optional steps

Show optional setup steps

• Install vaultar:

cd ~/projects/_personal
git clone https://github.com/aarondettmann/vaultar.git
cd vaultar
./install.sh

Git identity setup

The tracked git/.gitconfig keeps shared defaults, enforces explicit identity selection, and includes ~/.gitconfig.local. Machine-local identity routing is configured in ~/.gitconfig.local (untracked).

Set up layered identity files:

cp ~/.gitconfig.local.example ~/.gitconfig.local
cp ~/.gitconfig.work.example ~/.gitconfig.work
cp ~/.gitconfig.personal.example ~/.gitconfig.personal
$EDITOR ~/.gitconfig.local ~/.gitconfig.work ~/.gitconfig.personal

Use ~/projects/... repositories for work identity and ~/projects/_personal/... repositories for personal identity. This matches the tracked includeIf rules in git/.gitconfig.local.example. Verify the resolved identity for each repository:

git config --show-origin --show-scope --get user.email

Validation

Run configuration checks locally (the same checks used by CI):

./scripts/validate-config.sh

For strict CI parity (fail if optional tools are missing):

./scripts/validate-config.sh --strict-tools

---