How b-a-l-a-z-s/talos works
This repository declares and operates a personal Talos-based Kubernetes homelab, rather than implementing a standalone application. Its central workflow is Git-defined cluster configuration continuously reconciled by Flux into Kubernetes workloads; users reach home, media, and other services through the cluster’s internal or public networking. The graph also preserves the documented Talos/Proxmox foundation, storage and backups, security, and observability. Workload directories are represented at subsystem level because their individual configurations were not sampled; relationships reflect README statements, not inspection of those files.
Main entry points: networking Ingress and CNI · kubernetes Kubernetes cluster config · main Git configuration · flux-system Flux reconciliation
Components 19
Cluster platform
- Git configuration
clusters/main - Flux reconciliation
clusters/main/kubernetes/flux-system - Talos node config
clusters/main/talos - Kubernetes cluster config
clusters/main/kubernetes
Applications
- Home services
clusters/main/kubernetes/apps/home - Media services
clusters/main/kubernetes/apps/media - Download services
clusters/main/kubernetes/apps/downloaders - OSINT tools
clusters/main/kubernetes/apps/osint - External services
clusters/main/kubernetes/apps/external
Networking security
- Ingress and CNI
clusters/main/kubernetes/networking - Cloudflare tunnel
clusters/main/kubernetes/apps/security/cloudflared - Cluster security
clusters/main/kubernetes/apps/security
Storage observability
- Persistent storage
clusters/main/kubernetes/system - Backup configuration
clusters/main/components/backup - Metrics logs alerts
clusters/main/kubernetes/observability
Other components
- Cluster operator
- Proxmox host
- LAN and internet users
- TrueNAS storage VM
Connections 15
- Cluster operator → Git configuration: updates config
README.md - Git configuration → Flux reconciliation: reconciled by
README.md - Flux reconciliation → Kubernetes cluster config: reconciles config
README.md - Proxmox host → Talos node config: hosts VM
README.md - Talos node config → Kubernetes cluster config: runs cluster
README.md - LAN and internet users → Ingress and CNI: accesses services
README.md - Cloudflare tunnel → Ingress and CNI: tunnels to ingress
README.md - Ingress and CNI → Home services: routes requests
README.md - Ingress and CNI → Media services: routes requests
- Ingress and CNI → Download services: routes requests
- Ingress and CNI → External services: routes requests
- Cluster security → Ingress and CNI: protects public ingress
README.md - TrueNAS storage VM → Persistent storage: provides network storage
README.md - Persistent storage → Backup configuration: supports recovery
- Metrics logs alerts → Kubernetes cluster config: monitors cluster
README.md