Guides

Practical, hands-on walkthroughs.

• Managing dotfiles across machines back up, restore, and sync your dotfiles and the whole machine, from symlinks to a reproducible apply.
• Migrate from GNU Stow convert each stow package to a role or to the dotfiles role, retire stow / unstow / restow, and gain packages, templating, per-host config, and secrets.
• Migrate from a hand-rolled bootstrap repo map a Holman-style layout (topic folders, *.symlink, *.zsh, a bootstrap script) onto roles, vars, and the dotfiles role.
• One repo for your Windows, Ubuntu, and macOS machines a shared baseline plus per-machine roles and git identity for a cross-platform fleet.
• Set up a company dotfiles collection pair your own company.roles roles with the public collection so a whole team shares a baseline, no fork.
• Hand off from an Ubuntu autoinstall shrink your Subiquity late-commands to a handoff and turn curl | bash installers into idempotent roles.
• Keep $HOME clean with XDG Base Directories set the XDG_* variables to their defaults and point individual tools at ~/.config and friends.
• Tune macOS with system defaults a curated defaults write recipe book for the macos role, covering the keyboard, Finder, screenshots, the Dock, and panels, applied as settings you declare.
• Connect Lens on Windows to GKE through WSL make the Lens Kubernetes IDE refresh GKE tokens through the gcloud that lives in WSL, with shims, exec.env, and WSLENV.