Cross-platform dotfiles: How do you keep your homedir synced across different machines and OSs?

[VECTORG99]

🏷️ Discussion Type

Question

💬 Feature/Topic Area

Projects

Body

As a dev working on os-santiago/homedir, we spend a lot of time thinking about how to structure the perfect, clean, and reliable home directory setup.

One of the biggest challenges we often discuss is portability. Do you use the exact same configurations for macOS, Linux, and maybe even WSL? How do you handle machine-specific settings, conditional configs, or API secrets without cluttering your main git history?

We are actively building and refining our approach over at os-santiago/homedir, and we'd love to hear your strategies. Do you rely on tools like GNU Stow, Chezmoi, Ansible, Nix, or just a good old custom bash script? Let's share some knowledge!

I'd love to read about your current stack and what works best for you.

Guidelines

• I have read the above statement and can confirm my post is relevant to the GitHub feature areas Issues and/or Projects.

[Axel-DaMage]

Hi,

For cross-platform dotfiles, heres the most effective strategies:

• Core Tools: Chezmoi is the industry standard for handling OS differences via conditional templates. Nix offers strict reproducibility, while GNU Stow is best for simple symlinking (though it requires custom bash scripts for OS logic).
• Secrets Management: Never commit plain text. Dynamically inject secrets during setup using 1Password/Bitwarden CLIs, or encrypt repository files using SOPS or git-crypt.
• Machine-Specific Settings: Keep .gitignored override files (e.g., ~/.zshrc.local) and source them at the end of your main configs to keep machine-specific quirks out of version control.