Personal dotfiles managed with GNU Stow.
Each top-level directory is a stow package whose contents mirror the
target paths under $HOME. Running stow creates symlinks from $HOME
into the package; restow refreshes them.
- macOS: full support
- Ubuntu/Debian: full support (Homebrew on Linux for CLI tools)
- Fedora Atomic: host stays minimal (rpm-ostree layers the host packages
missing from the base image: tmux, stow, syncthing, tailscale, rbw,
neovim, wireguard-tools). User-space host tools (starship, devpod,
docker-compose v2) go to
~/.local/binand~/.docker/cli-plugins/. Per-project dev environments via devpod (devpod up <repo>) - Omarchy: pacman installs the same host packages as Fedora Atomic.
Omarchy's own desktop and dev tools stay as shipped; the
hyprpackage adds vim-style (SUPER + H/J/K/L) window focus and natural touchpad scrolling, and theomarchypackage a Bloemium screensaver
Plain Fedora (non-Atomic) is not supported.
Requires curl. Install first if missing:
- Ubuntu/Debian:
sudo apt-get update && sudo apt install -y curl
bash <(curl -fsSL https://raw.githubusercontent.com/arjenbloemsma/dotfiles/trunk/bootstrap.sh)Assumes git and stow are already installed. install.sh aborts
if either is missing. For a clean machine, use the bootstrap one-liner
above instead.
git clone git@github.com:arjenbloemsma/dotfiles.git ~/dotfiles
cd ~/dotfiles
./install.shFor a temp or exploration machine. Installs syncthing via the native package
manager, creates ~/notes-vault, starts the service, pairs with the
always-on hub, and shares the notes-vault folder with it. No
full dotfiles install. Works on bare macOS (requires brew), Debian/Ubuntu,
Omarchy, Fedora. On Fedora Atomic it layers syncthing and stops for a reboot,
so run it again afterwards.
The script needs the hub's device ID, supplied via either a config
file or an env var. Device IDs leak IPs through the public discovery
server, so do not commit them; scripts/notes-mesh.conf.local is
gitignored.
One-liner (no clone), env var:
NOTES_MESH_PEERS_ENV="DEVICE_ID|<device-label>" \
bash <(curl -fsSL https://raw.githubusercontent.com/arjenbloemsma/dotfiles/trunk/scripts/join-notes-mesh.sh)Multiple peers (hub plus optional direct P2P) are comma-separated:
"ID1|<device-label>,ID2|<device-label>".
Repo already cloned, config file:
cp ~/dotfiles/scripts/notes-mesh.conf.template ~/dotfiles/scripts/notes-mesh.conf.local
# edit notes-mesh.conf.local with the hub's device ID + name
~/dotfiles/scripts/join-notes-mesh.shAfter running on the new box: open the hub's web UI from a
machine that already has SSH access to it (e.g. the primary workstation,
not the new box itself). Accept the two prompts, "New Device" for the
new hostname, then "New Folder" to share notes-vault back. Sync starts
automatically.
If the hub's GUI binds to localhost (default), reach it via SSH tunnel
from that primary machine. Pick a free local port to avoid clashing
with the local syncthing on 8384:
ssh -L 8385:127.0.0.1:8384 <machine alias>
# then http://127.0.0.1:8385 in the browserscripts/backup-notes-vault.sh takes a daily snapshot of the notes vault.
It runs on the server that stores the vault, not on a workstation, and is
not part of stow or install.sh. Copy it there and run it from cron:
rsync scripts/backup-notes-vault.sh <machine alias>:/usr/local/bin/
ssh <machine alias> 'chmod +x /usr/local/bin/backup-notes-vault.sh'0 3 * * * /usr/local/bin/backup-notes-vault.sh
Each snapshot under /backups/notes-vault/<date> is a full browsable copy.
Unchanged files are hard links to the previous day, so only changes cost
diskspace. Snapshots older than 30 days are pruned. Paths are set at the
top of the script.
On first run, bootstrap checks for the host packages (tmux, stow,
syncthing, tailscale, rbw, neovim, wireguard-tools), layers whatever is
missing via rpm-ostree and exits. Layered packages are only
available after reboot, so the rest of the install (stow) can't proceed
yet. After reboot, install.sh provisions the devpod runtime:
starship, devpod, and Docker Compose v2 land in ~/.local/bin and
~/.docker/cli-plugins/; the rootless podman user socket is enabled;
devpod's docker provider is configured to use podman.
# First run: layers packages, then exits
bash <(curl -fsSL https://raw.githubusercontent.com/arjenbloemsma/dotfiles/trunk/bootstrap.sh)
sudo systemctl reboot
# Second run: detects layered packages on PATH and continues through install.sh
bash <(curl -fsSL https://raw.githubusercontent.com/arjenbloemsma/dotfiles/trunk/bootstrap.sh)Per-project dev environments live in each repo's
.devcontainer/devcontainer.json and run via devpod up <repo>.
No host-level dev tooling needed beyond what bootstrap provisions.
- Create
~/.config/shell/local.shfor machine-specific env exports (sourced first by both shells) - Press
prefix + Iin tmux to install plugins
Run from inside the dotfiles dir. Always pass --target to be explicit
about where symlinks land, regardless of where the repo is cloned:
stow --target="$HOME" --restow <package-name> # update
stow --target="$HOME" --delete <package-name> # remove
./install.sh --dry-run # preview changesSee install.sh for the full list of stow packages, CLI tools, and
GUI apps. Shared package lists live in scripts/lib/ and are sourced
by install.sh.
- Shell: macOS uses zsh, Linux uses bash (system defaults). Both source shared config from
~/.config/shell/:env.sh,aliases.sh,functions.sh, plus a per-OS file (e.g.macos.sh,fedora.sh). - First-time install on Linux: the OS's default
~/.bashrcand~/.bash_profileconflict with the stowed versions.install.shprints the diff and asksReplace? [y/N]for each one. Always review the diff. The OOTB Fedora.bashrcbehaviour (system/etc/bashrcsourcing,$HOME/.local/binon PATH) is already covered byshell/fedora.sh; for other distros or hand-edited files, port anything useful into the rightshell/<distro>.shfirst. - Machine-local overrides:
~/.config/shell/local.sh, sourced first by both shells, not tracked - DNS (Linux):
bootstrap.shrunsscripts/setup-system-dns.shto switch the host to Quad9 + Mullvad and ignore DHCP-supplied DNS. Idempotent. - Lid close (Omarchy laptops):
install.shrunsscripts/setup-lid-hibernate.shso a closed lid suspends and then hibernates after 10 minutes. Skipped on machines without a lid or without hibernation. Idempotent. - Secrets: git name and email live in
~/.config/git/config.local(not tracked).install.shchecks them against the Vaultwarden itemgit-identityand sets them when they differ - Tmux plugins: Managed by TPM, not tracked in git