Overview

Overview

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

Alternates

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. Templates allow you to use alternate sections within files.

Details

Encryption

Encryption

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

Bootstrap

Bootstrap

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

Explore how

Hooks

Hooks

Perform custom operations before or after any yadm command.

Get started

FAQ

FAQ

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

Get answers

Manual

Manual

View the manual online.

See man page

Examples

Example Dotfiles

Need some inspiration? Here are some example dotfiles repository.

View examples

Contribute

Contribute

Improve yadm by reporting bugs, coding changes, documentation and packaging yadm installations.

Read guidlines

If you enjoy using yadm, consider adding a star to the repository on GitHub. The star count helps others discover yadm.