How frankoslaw/homelab-2026 works
This repository configures homelab hosts and describes container deployments: Ansible playbooks and roles automate host setup, while Quadlet files define production rootless Podman services and Compose files serve local development and testing. The README documents those tool roles but not exact playbook-to-role or service-to-service wiring, so the graph avoids inferring those links. The Compose catalog includes additional applications whose production deployment is not represented by Quadlet files in this tree.
Main entry points: setup_host.yml Host setup · bookstack BookStack services · forgejo Forgejo service · traefik Traefik proxy
Components 23
Host provisioning
- Host setup
provisioning/setup_host.yml - Bootstrap
provisioning/bootstrap.yml - Common configuration
provisioning/roles/common - Docker install
provisioning/roles/docker_install - Podman install
provisioning/roles/podman_install - Podman user setup
provisioning/roles/podman_user
Production services
- BookStack services
quadlets/bookstack - Forgejo service
quadlets/forgejo - Traefik proxy
quadlets/traefik - Whoami service
quadlets/whoami
Local app manifests
- BookStack manifest
compose/bookstack/compose.yml - Diun manifest
compose/diun/compose.yml - Dockge manifest
compose/dockge/compose.yml - Dozzle manifest
compose/dozzle/compose.yml - Forgejo manifest
compose/forgejo/compose.yml - Memos manifest
compose/memos/compose.yml - Passbolt manifest
compose/passbolt/compose.yml - SFTPGo manifest
compose/sftpgo/compose.yml - Traefik manifest
compose/traefik/compose.yml - Uptime Kuma manifest
compose/uptime_kuma/compose.yml
Container runtimes
- Rootless Podman
- Compose runtime
Other components
- Homelab admin
Connections 20
- Homelab admin → Host setup: runs
- Homelab admin → Bootstrap: runs
- Host setup → Common configuration: configures hosts
- Host setup → Docker install: automates setup
- Host setup → Podman install: automates setup
- Host setup → Podman user setup: automates setup
- BookStack services → Rootless Podman: defines services for
- Forgejo service → Rootless Podman: defines service for
- Traefik proxy → Rootless Podman: defines proxy for
- Whoami service → Rootless Podman: defines service for
- BookStack manifest → Compose runtime: runs with
- Diun manifest → Compose runtime: runs with
- Dockge manifest → Compose runtime: runs with
- Dozzle manifest → Compose runtime: runs with
- Forgejo manifest → Compose runtime: runs with
- Memos manifest → Compose runtime: runs with
- Passbolt manifest → Compose runtime: runs with
- SFTPGo manifest → Compose runtime: runs with
- Traefik manifest → Compose runtime: runs with
- Uptime Kuma manifest → Compose runtime: runs with