debops.yadm

Yet Another Dotfiles Manager (yadm) is a wrapper script around the git command that manages dotfiles located in the $HOME directory using a git repository. yadm supports encrypted storage for sensitive files, alternative file selection based on host class/OS/hostname/user account, bootstrap script and Jinja templating.

The debops.yadm Ansible role will install the yadm script, either from an APT repository, or using the upstream git repository. The role will also install a zsh shell and a few essential CLI applications.

Optionally, debops.yadm role can clone selected dotfiles git repositories to the host creating mirrors, that can be used by users or other Ansible roles to deploy dotfiles locally.

• Getting started
  • Default dotfiles
  • Unsafe Repository error handling
  • Example inventory
  • Example playbook
  • Ansible tags
  • Other resources
• debops.yadm default variables
  • General configuration
  • APT packages
  • Upstream yadm installation
  • Custom dotfiles
  • Configuration for other Ansible roles
• Default variable details
  • yadm__dotfiles

Copyright

debops.yadm - Manage yadm, Yet Another Dotfiles Manager

Copyright (C) 2019 Maciej Delmanowski <drybjed@gmail.com>
Copyright (C) 2019 DebOps <https://debops.org/>
SPDX-License-Identifier: GPL-3.0-only

This Ansible role is part of DebOps.

DebOps is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 3, as
published by the Free Software Foundation.

DebOps is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with DebOps. If not, see https://www.gnu.org/licenses/.