xbxd/ansible-collection-homelab
Homelab Roles
A handful of Ansible roles I reuse around the homelab, for dotfile setup, Docker environment files and Komodo. Keeps the bits I repeat out of one-off playbooks.
Project details
Primary language: Python
Last commit:
Language mix
- Python 84%
- Jinja 11%
- Shell 5%
Weekly commits
Commit counts by UTC week start for the last 52 weeks.
28 commits total; busiest week: 2026-11-08 (6 commits).
README
xbxd.homelab
Private Ansible collection for Brendan's homelab and Steady Digital infrastructure.
Roles
| Role | Purpose |
|---|---|
xbxd.homelab.chezmoi |
Install and configure chezmoi for root and the primary user, with scoped [data] keys driven from inventory. |
xbxd.homelab.compose_root_env |
Manage owner-only nonsecret host settings for a root Docker Compose environment. |
xbxd.homelab.komodo |
Install and configure the Komodo Periphery agent as a systemd --user service. |
Usage
In the consuming playbook project, add to requirements.yml:
collections:
- name: https://<your-forgejo-host>/xbxd/ansible-collection-homelab.git
type: git
version: 0.2.0And in ansible.cfg:
[defaults]
collections_path = ./collectionsInstall: ansible-galaxy collection install -r requirements.yml.
Reference roles by FQCN in plays:
- hosts: servers
roles:
- xbxd.homelab.chezmoi
- xbxd.homelab.compose_root_env
- xbxd.homelab.komodoVersioning
Plain X.Y.Z SemVer tags. Bump version: in galaxy.yml and tag the matching commit.
To upgrade in a consumer: bump the version: in requirements.yml and run
ansible-galaxy collection install -r requirements.yml --upgrade.
License
MIT