Skip to content

chezmoi

Manage your dotfiles across multiple diverse machines, securely.

The latest version of chezmoi is 2.27.2 (release notes, release history).

chezmoi helps you manage your personal configuration files (dotfiles, like ~/.gitconfig) across multiple machines.

chezmoi provides many features beyond symlinking or using a bare git repo including: templates (to handle small differences between machines), password manager support (to store your secrets securely), importing files from archives (great for shell and editor plugins), full file encryption (using gpg or age), and running scripts (to handle everything else).

With chezmoi, pronounced /ʃeɪ mwa/ (shay-moi), you can install chezmoi and your dotfiles from your GitHub dotfiles repo on a new, empty machine with a single command:

$ sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply $GITHUB_USERNAME

As well as the curl | sh installation, you can install chezmoi with your favorite package manager.

Updating your dotfiles on any machine is a single command:

$ chezmoi update

How do I start with chezmoi?

Install chezmoi then read the quick start guide. The user guide covers most common tasks. For a full description, consult the reference.

Should I use chezmoi?

See what other people think about chezmoi by reading articles, listening to podcasts, and watching videos about chezmoi. Read how chezmoi compares to other dotfile managers. Explore other people's dotfile repos that use chezmoi on GitHub, GitLab, and Codeberg.

I like chezmoi. How do I say thanks?

Please give chezmoi a star on GitHub.

Share chezmoi and, if you're happy to share your public dotfiles repo, then tag your repo with chezmoi.

Contributions are very welcome and every bug report, support request, and feature request helps make chezmoi better. Thank you :)

chezmoi does not accept financial contributions. Instead, please make a donation to a charity or cause of your choice.