How phsaurav/home-lab works
This repository describes a homelab infrastructure managed as code: Terraform provisions environments on Proxmox, Ansible configures hosts, and ArgoCD deploys Kubernetes applications. Its documented capabilities also include secret management, monitoring, self-hosted services, and network ingress. The README is the only relationship evidence available here; links below reflect documented relationships, not inspection of implementation details.
Main entry points: apps Kubernetes Applications · playbooks Ansible Configuration · environments Terraform · argocd ArgoCD GitOps
Components 19
Infrastructure Provisioning
- Terraform
proxmox/environments - Proxmox VE
- VMs and Containers
proxmox/modules
Hosts and Clusters
- Dev Ubuntu Hosts
ansible/inventories/dev - Prod Hosts
ansible/inventories/prod - Talos Kubernetes
talos
Configuration and GitOps
- Ansible Configuration
ansible/playbooks - ArgoCD GitOps
argocd - Kubernetes Applications
argocd/apps
Services and Networking
- Prometheus and Grafana
argocd/apps/monitoring - Gitea
argocd/apps/gitea - Harbor
argocd/apps/harbor - DWC App and MySQL
argocd/apps/dwc-app - Traefik Proxy
traefik - Cloudflare DNS and Tunnel
Secrets
- HashiCorp Vault
vault - Ansible Vault
ansible/secret.yaml - SOPS Encryption
.sops.yaml
Other components
- Homelab Operator
Connections 18
- Homelab Operator → Terraform: provisions with
README.md - Terraform → Proxmox VE: provisions assets
README.md - Terraform → VMs and Containers: creates environments
README.md - Homelab Operator → Ansible Configuration: configures with
README.md - Ansible Configuration → Dev Ubuntu Hosts: configures hosts
README.md - Ansible Configuration → Prod Hosts: configures hosts
README.md - Homelab Operator → ArgoCD GitOps: deploys through
README.md - ArgoCD GitOps → Kubernetes Applications: deploys apps
README.md - ArgoCD GitOps → HashiCorp Vault: integrates via plugin
README.md - Ansible Vault → Ansible Configuration: protects credentials
README.md - SOPS Encryption → HashiCorp Vault: protects credentials
README.md - Kubernetes Applications → Prometheus and Grafana: includes monitoring
README.md - Kubernetes Applications → Gitea: includes hosting
README.md - Kubernetes Applications → Harbor: includes registry
README.md - Kubernetes Applications → DWC App and MySQL: includes application
README.md - Homelab Operator → Talos Kubernetes: deploys workloads
README.md - Homelab Operator → Traefik Proxy: uses proxy
README.md - Homelab Operator → Cloudflare DNS and Tunnel: uses DNS and tunnel
README.md