// the find
zimmertr/TJs-Kubernetes-Service
Enable enthusiasts and administrators alike to easily provision highly available and production-ready Kubernetes clusters on Proxmox VE.
TKS is a Terraform project that spins up a Talos Linux Kubernetes cluster on Proxmox VE. It targets homelabbers and self-hosters who want a real HA control plane without manually wrestling with kubeadm or k3s. The stack is opinionated — Talos for the OS, bpg provider for Proxmox, ArgoCD implied for app delivery.
The combination of Talos (immutable, API-only OS) and Terraform means cluster state is reproducible and you never SSH into nodes for config changes. Scaling is handled cleanly through Terraform variable changes rather than manual node joins, with automatic node drain/removal on scale-down. The project is actively maintained — last push was four days ago and Renovate is configured to keep provider versions current. Using Talos image factory for boot images means you don't have to manage ISO uploads manually.
The 9-node-per-role hard limit due to DHCP/MAC addressing scheme is a real ceiling for anyone outgrowing a homelab. The DNS and DHCP setup is entirely out-of-band — you must pre-create records manually, which is friction the Terraform could theoretically handle. The troubleshooting section includes a raw SSH one-liner with xargs qm destroy that will silently nuke VMs matching a numeric grep pattern — it works until it doesn't. No GitOps bootstrap is included; the README just links to a separate manifests repo, so the gap between 'cluster is up' and 'apps are running' is left as an exercise.