How securitybits-io/homelab works
Securitybits Homelab is infrastructure-as-code and operational configuration for a Proxmox-based home environment. The principal workflow is to provision VM templates and workload VMs with separate Terraform roots, configure hosts with Ansible, then deploy Nomad job specifications and variable files to the cluster. The graph also preserves the documented DNS, retained Compose applications, and workload categories. Relationships are based on the README’s architecture and workflow descriptions; no source excerpts were available to verify implementation details.
Main entry points: ansible Ansible playbooks · terraform Workload Terraform · apps Retained Compose apps · templates Template Terraform
Components 20
VM provisioning
- Template Terraform
templates - Debian VM template
templates - Workload Terraform
terraform - Proxmox cluster
- Hashistack VMs
terraform - Legacy VMs
terraform - Namecheap DNS
Host configuration
- Ansible playbooks
ansible - Host configuration roles
ansible/roles - Nomad variable files
ansible/host_vars/nomad/jobs-vars
Nomad orchestration
- Nomad cluster
- Nomad job specs
jobs
Workloads and services
- Application jobs
jobs/hashilab-apps - Service jobs
jobs/hashilab-services - Support jobs
jobs/hashilab-support - Development jobs
jobs/hashilab-dev - Retained Compose apps
apps - Monitoring stack
apps/monitoring - Stash app
apps/stash
Other components
- Homelab operator
Connections 24
- Homelab operator → Template Terraform: manages template
README.md - Homelab operator → Workload Terraform: manages infrastructure
README.md - Template Terraform → Debian VM template: creates template
README.md - Debian VM template → Proxmox cluster: runs on
README.md - Workload Terraform → Hashistack VMs: provisions
README.md - Workload Terraform → Legacy VMs: provisions
README.md - Hashistack VMs → Proxmox cluster: runs on
README.md - Legacy VMs → Proxmox cluster: runs on
README.md - Workload Terraform → Namecheap DNS: manages DNS
README.md - Homelab operator → Ansible playbooks: runs playbooks
README.md - Ansible playbooks → Hashistack VMs: configures hosts
README.md - Ansible playbooks → Legacy VMs: configures hosts
README.md - Ansible playbooks → Host configuration roles: applies roles
README.md - Ansible playbooks → Nomad job specs: copies job specs
README.md - Ansible playbooks → Nomad variable files: deploys variables
README.md - Nomad variable files → Nomad cluster: configures variables
README.md - Nomad job specs → Nomad cluster: submits jobs
README.md - Nomad cluster → Application jobs: runs workloads
README.md - Nomad cluster → Service jobs: runs workloads
README.md - Nomad cluster → Support jobs: runs workloads
README.md - Nomad cluster → Development jobs: runs workloads
README.md - Homelab operator → Retained Compose apps: maintains applications
README.md - Retained Compose apps → Monitoring stack: includes
README.md - Retained Compose apps → Stash app: includes
README.md