¶ Cluster Architecture Overview
End-to-end view of the homelab Kubernetes cluster — 7 nodes, 51 namespaces, 4 Proxmox hosts.
¶ Full System Architecture
All 27 architecture diagrams are available as professional 4K SVGs in the Architecture Diagram Gallery.
¶ Key Facts
| Fact | Value |
|---|---|
| k3s version | v1.34.4+k3s1 |
| Nodes | 7 (3 CP + 4 worker) |
| Namespaces | 51 active |
| Proxmox hosts | 4 (ThinkCentre M920q) |
| Longhorn | ~1.2 TiB across agent-1/2/3 |
| NAS | DXP4800 19TB, LACP 5Gbps |
| Inference | Mac Studio M3 Ultra 256GB |
¶ Style Guide
Diagrams follow these standards for promotional-quality visuals:
- Canvas: 3840px wide (4K), vector — infinitely zoomable
- Background:
#0f0f1a(near-black) - Font: Helvetica, 18px minimum, 24px+ for titles
- Lines: Clean (roughness 0), 2px stroke
- Spacing: 40px+ between elements
- Colors: AWS navy
#232F3E, orange#FF9900, green#22c55e, blue#3b82f6, purple#8b5cf6
Regenerate all SVGs:
python3 docs/diagrams/generate_svg.py
Stack: Python SVG generator → Simple Icons (MIT) → Wiki.js assets
¶ Related Pages
- Architecture Diagram Gallery — all 27 professional 4K SVG diagrams
- Deployed Applications — master inventory
- Excalidraw — self-hosted whiteboard
- Ingress Architecture — route table and auth middleware
- Storage Architecture — Longhorn, NFS, backup pipeline
- WireGuard Collective Mesh — hub-and-spoke VPN