Overview
This repository holds the configuration for my home Kubernetes cluster: a 7-node bare-metal cluster running Talos Linux and managed through GitOps.
- topf generates and applies the Talos machine configs.
- Flux reconciles the cluster state from this repository.
- Renovate opens pull requests for dependency updates.
- Terraform manages the services outside the cluster (Akeyless, Authentik, Backblaze, Garage), planned and applied through Atlantis.
Repository layout
| Directory |
Purpose |
k8s/ |
Everything Flux reconciles: apps, shared Kustomize components and the Flux entrypoint |
talos/ |
Node configuration (topf.yaml plus patches for all nodes, control plane, workers and single nodes) |
terraform/ |
External services, one workspace per service |
bootstrap/ |
One-time cluster bootstrap (CRDs, Flux Operator and encrypted bootstrap secrets) |
omv/ |
Docker Compose services on the NAS, outside the cluster |
Topology
The nodes share one gigabit switch, with a Raspberry Pi 4 as the NAS. The network is flat for now.
graph LR
INET[ISP Router] --> SW[TP-Link LS108G<br/>8-port GbE]
subgraph CP [Control plane]
M1[bmax1-master]
M2[soyo2-master]
M3[soyo3-master]
end
subgraph W [Workers]
W1[hp-worker1]
W2[hp-worker2]
W3[hp-worker3]
W4[localstorage-worker1]
end
SW --> CP
SW --> W
SW --> NAS[Raspberry Pi 4<br/>OpenMediaVault]
Hardware
| Node |
Role |
Model |
Disk |
RAM |
| bmax1-master |
Control plane |
Bmax B1 Pro (N4000) |
128 GB SSD |
8 GB |
| soyo2-master |
Control plane |
SOYO M2 Plus v1 |
512 GB SSD |
16 GB |
| soyo3-master |
Control plane |
SOYO M2 Plus v1 |
512 GB SSD |
16 GB |
| hp-worker1 |
Worker |
HP EliteDesk 800 G3 |
240 GB SSD |
20 GB |
| hp-worker2 |
Worker |
HP Compaq 8300 SFF |
1 TB HDD + 240 GB SSD |
28 GB |
| hp-worker3 |
Worker |
HP Compaq 8300 SFF |
500 GB HDD + 240 GB SSD |
32 GB |
| localstorage-worker1 |
Worker |
SOYO N95 |
512 GB SSD |
16 GB |
| NAS |
OpenMediaVault |
Raspberry Pi 4 |
3 TB (2 + 1) |
8 GB |
Core components
| Area |
Components |
| Networking |
Cilium, Envoy Gateway, cloudflared, external-dns, Tailscale Operator, cert-manager, Spegel |
| Storage |
Longhorn, OpenEBS, Garage, Zot, Dragonfly, VolSync |
| Security |
External Secrets (Akeyless), Authentik, Kyverno, Trivy Operator |
| Observability |
kube-prometheus-stack, Grafana, VictoriaLogs, OpenTelemetry, Gatus |
| Automation |
Flux, KEDA, Tuppr, Renovate |