Watch the complete homelab setup walkthrough on YouTube.
flowchart LR
Proxmox --> K8s
K8s --> Services
Proxmox -.-> NAS
Services -.-> NAS
/home/decoder/dev/homelab
├── docs/ # Essential documentation
│ ├── CLAUDE.md # Claude AI context
│ ├── README.md # This file
│ └── secrets-management.md
├── gitops/ # All Kubernetes manifests
│ ├── apps/ # Application deployments
│ │ ├── homepage.yaml # Homepage dashboard
│ │ ├── minio.yaml # MinIO object storage
│ │ ├── portainer.yaml # Portainer UI
│ │ └── velero.yaml # Backup solution
│ ├── clusters/
│ │ └── homelab/ # ArgoCD root applications
│ │ ├── apps.yaml
│ │ └── infrastructure.yaml
│ └── infra/ # Infrastructure components
│ ├── eso-*.yaml # External Secrets Operator
│ ├── metallb-*.yaml # Load balancer
│ └── prometheus.yaml # Monitoring stack
├── scripts/ # Utility scripts
│ └── check-metallb-health.sh
├── terraform/ # Infrastructure as Code
│ └── argocd/ # ArgoCD Terraform deployment
├── devbox.json # Development environment
└── justfile # Task automation
- Kubernetes cluster (1.28+)
kubectlconfigured- Terraform installed
justcommand runner (optional but recommended)
devbox shell # Enters shell with all toolsProvides: kubectl, helm, terraform, argocd, istioctl, kn, fluxcd
cd terraform/argocd
terraform init
terraform apply# Using justfile recipes
just launch_argo # Opens UI and copies password
# Or manually:
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -dkubectl apply -f gitops/clusters/homelab/- GitOps with ArgoCD: All deployments via Git commits
- Secret Management: HashiCorp Vault + External Secrets Operator
- Load Balancing: MetalLB for bare-metal LoadBalancer services
- Monitoring: Prometheus + Grafana stack
- Backup: Velero with MinIO backend
- Dashboard: Homepage with service integration
- AI Platform: Kagent with local Ollama integration
See just --list for all available commands:
just launch_argo- Open ArgoCD UI with password in clipboardjust launch_homepage- Open Homepage dashboardjust argo_suspend- Disable auto-sync for all appsjust argo_resume- Re-enable auto-sync for all appsjust argo_stop- Stop ArgoCD controller completelyjust argo_start- Start ArgoCD controllerjust argo_status- Check sync status of all applications
