If you know how to use Git, you already know how to use yadm. yadm helps you maintain a single repository of dotfiles, while keeping them where they belong—in $HOME. Anything you can do with Git, you can do using yadm.

Discover yadm

Alternate Files

Sometimes you need different configurations on different systems. yadm makes it possible to use alternate versions of files based on the OS or hostname of the system.



Configurations occasionally include secrets such as passwords, encryption keys, or other sensitive information. yadm allows you to add such files to an encrypted archive, which can be maintained alongside your other configurations.

Learn more


Define your own instructions to complete your dotfiles installation. If provided, yadm can execute your custom program immediately following a successful clone.

Explore how


Have a question? You might find an answer in the FAQ.

Get answers


View the manual online.

See man page

Example Dotfiles

Need some inspiration? Here are some example dotfiles repository.

View examples