Install yadm with Homebrew, apk, apt, MacPorts, Nix, pacman, zypper

Project links

• Homepage
• Repository

Commands and aliases

• yadm

Project history

The project was created by Tim Byrne and shared as open source in 2015, according to the author's Hacker News explanation. The motivation was portability, seamless Git interaction, alternate files for different hosts, and encryption for private data.

Early yadm solved a practical dotfiles problem: a bare Git repository in $HOME is powerful, but awkward around secrets, host-specific files, and new-machine bootstrap. yadm wrapped Git so the repository can track files in place while hiding the Git plumbing from day-to-day commands.

The 2.x and 3.x change logs show steady evolution rather than reinvention. Version 2.0.0 redesigned alternate processing, added XDG base-directory support, templates, distro-aware alternates, and an upgrade command; version 3.0.0 added OpenSSL encryption support, include directives in the built-in template processor, and moved default repository/encrypted archive locations under XDG-style data directories.

Adoption history

yadm spread through developer workstations and Unix package managers because it let users manage dotfiles without symlink farms or a custom DSL. The official site sells the core adoption hook clearly: anything a user can do with Git, they can do using yadm.

Its practical adoption is visible in distribution packages, docs, blog posts, and configuration-management roles. Users often pair it with broader system setup tools: yadm pulls dotfiles, decrypts secrets, selects alternates, and runs bootstrap scripts, while tools such as Home Manager, Ansible, or shell installers handle larger machine state.

How it is used

Typical usage starts with yadm init or yadm clone, then yadm add, commit, push, pull, and status in the same mental model as Git. The work tree is the user's home directory, so dotfiles remain where applications expect them.

The features that distinguish yadm from plain bare Git are alternates for OS/hostname/user/class differences, encrypted archives for sensitive files, bootstrap scripts for new machines, hooks around commands, and templates for generating machine-specific content.

Why package nerds care

yadm matters to package nerds because it is a thin wrapper over Git that resists inventing a second configuration-management universe. It packages the bare-repo dotfiles pattern into one command with just enough extra machinery for secrets and host variance.

It is also a clean example of a tool whose package value is ergonomic, not algorithmic: the hard dependency is already Git, but the wrapper codifies safe defaults, XDG paths, alternates, encryption, and bootstrap conventions that many users would otherwise script badly.

Timeline

• 2015: Tim Byrne shares yadm as an open-source dotfile manager focused on Git portability, alternates, and encryption.
• 1.10.0: yadm transitions to semantic versioning.
• 2.0.0: yadm adds XDG base-directory support, redesigns alternate processing, adds a built-in default template processor, distro-aware alternates, and an upgrade command.
• 3.0.0: yadm adds OpenSSL encryption support, built-in template includes, default-branch improvements, and new XDG-style default repository/archive paths.
• 2020s: yadm continues as a mature dotfile package across Homebrew, Debian/Ubuntu, Arch, Nix, MacPorts, Alpine, and other package ecosystems.

Related projects

• Git is the underlying storage and command model for yadm.
• chezmoi, GNU Stow, vcsh, homesick, and dotbot are neighboring dotfile-management tools with different tradeoffs around templating, symlinks, and repository layout.
• GPG, OpenSSL, git-crypt, and transcrypt are related through yadm's encrypted-file workflows.
• Nix Home Manager and Ansible often complement yadm by managing packages and system state while yadm manages personal files.

Sources

• https://github.com/yadm-dev/yadm
• https://github.com/yadm-dev/yadm/blob/master/CHANGES
• https://man.archlinux.org/man/extra/yadm/yadm.1.en
• https://news.ycombinator.com/item?id=27174878
• https://yadm.io/
• https://yadm.io/docs/faq
• https://yadm.io/docs/overview