Skip to content

chezmoi

Manage your dotfiles across multiple diverse machines, securely.

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 https://chezmoi.io/get)" -- init --apply $GITHUB_USERNAME

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

chezmoi provides many features beyond symlinking dotfiles or using a bare git repo including: dotfile 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).

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 of chezmoi, consult the reference.

Considering using chezmoi?

You can browse other people's dotfiles that use chezmoi on GitHub, on GitLab, and on Codeberg, read articles, listen to podcasts, and watch videos about chezmoi and see how chezmoi compares to other dotfile managers.