dotfiles-ansible/README.md

39 lines
1.5 KiB
Markdown

# dotfiles v2
This is the continuation of [my old dotfiles](/folliehiyuki/dotfiles) without all the Xorg stuff I don't use.
## 🧰 Setup
```bash
# Install `community.general` for 'apk' and 'doas' module if you only installed ansible-core
ansible-galaxy collection install -r requirements/collections.yml
# Run the playbook
ansible-playbook playbooks/dotfiles.yml
```
`extend.yml` playbook contains tasks unrelated to dotfiles deployment, but useful (for me).
Optional variables (not listed inside `group_vars/all/`) as they should be kept confidential:
- `pixiv_refresh_token`: used in gallery-dl config
- `google_calendar_id`, `google_oauth_client_id`, `google_oauth_client_secret`: used in calcurse CalDAV config
- `user_ssh_key_path`: configure Git to sign commits with this SSH key
## 📓 Notes
The main playbook probably works on whatever Linux distribution you are running (*haven't tested*).
The additional playbook gears toward my Linux distribution of choice - [Alpine Linux](https://alpinelinux.org). Tasks included in them might not work on other distributions (e.g. `apk` tasks)
## 🌟 Credits
- [eoli3n/dotfiles](https://github.com/eoli3n/dotfiles)
- [samhh/dotfiles](https://github.com/samhh/dotfiles)
- [zsugabubus/dotfiles](https://github.com/zsugabubus/dotfiles)
- [sircmpwn/dotfiles](https://git.sr.ht/~sircmpwn/dotfiles)
- [rjarry/dotfiles](https://git.sr.ht/~rjarry/dotfiles)
- [wangl-cc/dotfiles](https://github.com/wangl-cc/dotfiles)
## 📄 License
MIT