← All projects

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.

  • ansible
  • automation

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.0

And in ansible.cfg:

[defaults]
collections_path = ./collections

Install: 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.komodo

Versioning

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