Manage your dotfiles across multiple diverse machines, securely.
How do I start with chezmoi now? #
Install chezmoi then read the quick start guide. The how-to guide covers most common tasks, and there’s both documentation on templating and frequently asked questions for specific questions. You can browse other people’s dotfiles that use chezmoi on GitHub and on GitLab, and see how chezmoi compares to other dotfile managers. For a full description of chezmoi, consult the reference.
What does chezmoi do and why should I use it? #
chezmoi helps you manage your personal configuration files (dotfiles, like
~/.bashrc) across multiple machines.
chezmoi is helpful if you have spent time customizing the tools you use (e.g. shells, editors, and version control systems) and want to keep machines running different accounts (e.g. home and work) and/or different operating systems (e.g. Linux, macOS, and Windows) in sync, while still being able to easily cope with differences from machine to machine.
chezmoi has strong support for security, allowing you to manage secrets (e.g. passwords, access tokens, and private keys) securely and seamlessly using a password manager of your choice or GnuPG encryption.
In all cases you only need to maintain a single source of truth: a single branch in a version control system (e.g. git) for everything public and a single password manager for all your secrets.
If you do not personalize your configuration or only ever use a single operating system with a single account and none of your dotfiles contain secrets then you don’t need chezmoi. Otherwise, read on…
What are chezmoi’s key features? #
You can share as much configuration across machines as you want, while still
being able to control machine-specific details. You only need to maintain a
single branch. Your dotfiles can be templates (using
text/template syntax). Predefined
variables allow you to change behavior depending on operating system,
architecture, and hostname. chezmoi runs on all commonly-used platforms, like
Linux, macOS, and Windows. It also runs on less commonly-used platforms, like
FreeBSD, OpenBSD, and Termux.
Personal and secure #
Nothing leaves your machine, unless you want it to. You can use the version control system of your choice to manage your configuration, and you can write the configuration file in the format of your choice. chezmoi can retrieve secrets from 1Password, Bitwarden, gopass, KeePassXC, LastPass, pass, Vault, Keychain, Keyring, or any command-line utility of your choice. You can encrypt individual files with GnuPG. You can checkout your dotfiles repo on as many machines as you want without revealing any secrets to anyone.
chezmoi includes verbose and dry run modes so you can review exactly what changes it will make to your home directory before making them. chezmoi’s source format uses only regular files and directories that map one-to-one with the files, directories, and symlinks in your home directory that you choose to manage. If you decide not to use chezmoi in the future, it is easy to move your data elsewhere.
Declarative and robust #
You declare the desired state of files, directories, and symbolic links in your source of truth and chezmoi updates your home directory to match that state. What you want is what you get. chezmoi updates all files and symbolic links atomically. You will never be left with incomplete files that could lock you out, even if the update process is interrupted.
Fast and easy to use #
chezmoi runs in fractions of a second and makes most day-to-day operations one line commands, including installation, initialization, and keeping your machines up-to-date. chezmoi can pull and apply changes from your dotfiles repo in a single command, and automatically commit and push changes.
I already have a system to manage my dotfiles, why should I use chezmoi? #
How do people use chezmoi? #
Dotfile repos using chezmoi #
People talking about chezmoi #
Read what people have said about chezmoi.
What documentation is available? #
- Install guide to get chezmoi installed on your machine with one or two commands.
- Quick start guide for your first steps.
- How-to guide for achieving specific tasks.
- Templating guide for working with templates.
- FAQ for questions that aren’t answered elsewhere.
- Changes for non-backwards compatible changes.
- Reference for a complete description of chezmoi.
- Comparison guide for a comparison with other dotfile managers.
- Contributing for people looking to contribute to or package chezmoi.