This repository contains the infrastructure and cluster configuration for my homelab.
| Path | Purpose |
|---|---|
infrastructure/ |
OpenTofu code to provision Talos-based Kubernetes nodes on Proxmox |
clusters/ |
Flux GitOps configuration for the Kubernetes cluster |
All repository documentation lives under docs/.
- Infrastructure Overview architecture, providers, and repo layout
- Infrastructure Setup initial bootstrap workflow and local config installation
- Infrastructure Configuration node schema, defaults, and Talos patching model
- Networking Proxmox, OPNsense, switch, VLAN, and network ranges
- Infrastructure Upgrades rolling replacement upgrade model and storage guidance
- Troubleshooting common OpenTofu, Talos, Proxmox, and networking issues
- Cluster Infrastructure overview of post-bootstrap cluster configuration
- MetalLB BGP MetalLB FRR mode with OPNsense BGP peering
- Flux Overview architecture, component list, repo layout, and dependency graph
- Flux Setup prerequisites, variables, and bootstrap workflow
- Flux Operations day-2 operations: adding components, reconciling, upgrading
- Flux Troubleshooting common issues and fixes
| Network | Purpose | Notes |
|---|---|---|
10.0.30.0/24 |
Main LAN | Regular clients, Wi-Fi, and Proxmox management |
10.0.40.0/24 |
VM and Kubernetes node network | Routed by OPNsense on VLAN 40 |
10.0.50.100-10.0.50.150 |
MetalLB service IP pool | Routed over BGP, not bound to a bridge or interface |
- Provision Talos nodes with the code in
infrastructure/ - Export
kubeconfigandtalosconfig - Flux bootstraps automatically via OpenTofu and begins reconciling
clusters/homelab/ - Verify networking, BGP, and workload reachability
tofu init
tofu validate
tofu plan
tofu applyFor the detailed setup flow, see Infrastructure Setup.