README.md

Dotfiles

Personal dotfiles managed with GNU Stow.

Requirements

• GNU Stow

Install on Debian/Ubuntu:

sudo apt install stow

Install on macOS:

brew install stow

Install on Arch Linux:

sudo pacman -S stow

Installation

Clone the repository:

# You must use the `--recurse-submodules` flag otherwise configs won't be filled
# `-j8` is an optional performance optimization
git clone --recurse-submodules -j8 https://github.com/hamst/dotfiles.git ~/dotfiles
cd ~/dotfiles

# If you didn't use the `--recurse-submodules` flag initially, intiate submodules
git submodule update --init --recursive

Stow the desired packages:

stow package
## or just the whole directory at once
stow .

Alternatively, a nice way to setup (and ongoing as long as everything is committed)

stow --adopt .
git restore .

System configs (requires root)

Some configs (kernel module params, udev rules) live in /etc/ and aren't managed by Stow. Run the script to copy them:

./install-system.sh

Installing Other things

These items aren't automatically set up at the moment.

pnpm

# this relies on `npm` already being installed
npm install --global corepack@latest
# if using mise only
mise reshim
# install pnpm
corepack enable pnpm