How prateeksavanur/homelab-infra works
This repository provisions and configures a Proxmox homelab, then deploys cluster services. The documented workflow is operator-run Terraform provisioning followed by Ansible configuration of the hosts, k3s, AdGuard, and applications. The diagram preserves the documented DNS, ingress, storage, and service capabilities. Source excerpts were unavailable, so relationships are limited to those stated in the README; additional components visible only in the tree are not connected speculatively.
Main entry points: site.yml Ansible setup · main.tf Terraform provisioning · tasks/main.yml Application deployment · tasks/main.yml k3s cluster
Components 15
Infrastructure provisioning
- Terraform provisioning
terraform/main.tf
Host configuration
- Ansible setup
ansible/playbooks/site.yml - Host inventory
ansible/inventory/hosts.yml - OS baseline
ansible/roles/common/tasks/main.yml
Cluster services
- k3s cluster
ansible/roles/k3s_master/tasks/main.yml - Worker nodes
ansible/roles/k3s_worker/tasks/main.yml - Ingress and TLS
ansible/roles/k3s_master/tasks/main.yml - AdGuard DNS
ansible/roles/adguard/tasks/main.yml
Homelab applications
- Application deployment
ansible/roles/k3s_apps/tasks/main.yml - Jellyfin
ansible/roles/k3s_apps/files/jellyfin/deployment.yml - Website
ansible/roles/k3s_apps/files/website/deployment.yml - Media storage
ansible/roles/k3s_apps/files/storage/media-pv.yml
Other components
- Operator
- Proxmox host
- Home router
Connections 15
- Operator → Terraform provisioning: runs
README.md - Terraform provisioning → Proxmox host: provisions VMs
README.md - Operator → Ansible setup: runs
README.md - Terraform provisioning → Host inventory: outputs IP hint
README.md - Ansible setup → Host inventory: uses hosts
README.md - Ansible setup → OS baseline: configures baseline
README.md - Ansible setup → k3s cluster: sets up cluster
README.md - Ansible setup → Worker nodes: configures agents
README.md - k3s cluster → Ingress and TLS: includes
README.md - Ansible setup → AdGuard DNS: configures DNS
README.md - Home router → AdGuard DNS: uses for DNS
README.md - Ansible setup → Application deployment: deploys apps
README.md - Application deployment → Jellyfin: deploys
README.md - Application deployment → Website: deploys
README.md - Jellyfin → Media storage: uses media
README.md