https://github.com/mariuskimmina/ansible-role-dotfiles

Ansible Role - Easy and flexible dotfile installation with stow.
https://github.com/mariuskimmina/ansible-role-dotfiles

ansible dotfiles role stow

Last synced: about 2 hours ago
JSON representation

Ansible Role - Easy and flexible dotfile installation with stow.

• Host: GitHub
• URL: https://github.com/mariuskimmina/ansible-role-dotfiles
• Owner: mariuskimmina
• License: mit
• Created: 2022-04-18T15:54:06.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-10-06T13:17:20.000Z (about 1 year ago)
• Last Synced: 2024-04-22T00:31:40.369Z (7 months ago)
• Topics: ansible, dotfiles, role, stow
• Language: Python
• Homepage: https://galaxy.ansible.com/ui/standalone/roles/mariuskimmina/dotfiles/
• Size: 13.7 KB
• Stars: 10
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Ansible Role: Dotfiles

Installs a set of dotfiles from a given Git repostiory. By default it will use my [dotfiles repo][dotfiles] but you can easily change it to use yours.

Works for all dotfile repos that follow the [stow][stow] format ([blog post](https://brandon.invergo.net/news/2012-05-26-using-gnu-stow-to-manage-your-dotfiles.html)).

## Usage

1. Change the `dotfiles_repo` variable in `defaults/main.yml` to point to your dotfiles repo

2. Create a playbook with this Role

3. Run the playbook

## Dependencies

None

## Example playbook

```

---

- hosts: localhost

  roles:

    - { role: mariuskimmina.dotfiles }

  become: true

```

## Tests

Fully tested on:

* Fedora 36

* Ubuntu 20.04

## Credits

Inspired by: https://github.com/geerlingguy/ansible-role-dotfiles

The main difference between the original project and this one is the usage of [stow][stow].

[stow]: https://www.gnu.org/software/stow/

[dotfiles]: https://github.com/mariuskimmina/.dotfiles