fzymgc-house Cluster Documentation¶
Welcome to the documentation for the fzymgc-house self-hosted Kubernetes cluster. This cluster runs on TuringPi 2 hardware with RK1 compute modules, providing a complete home lab infrastructure for learning and experimentation.
Access Information
This documentation site is protected by Cloudflare Access. You must authenticate through Authentik to view these pages.
Quick Navigation¶
- :material-rocket-launch: **[Getting Started](getting-started/index.md)**
---
Environment setup, cluster access, and AI tooling configuration
- :material-tools: **[Operations](operations/index.md)**
---
Day-to-day operational guides for Vault, Authentik, Cloudflare, and more
- :material-book-open-variant: **[Reference](reference/index.md)**
---
Technical reference for services, technologies, networking, and secrets
- :material-sitemap: **[Architecture](architecture/index.md)**
---
System design, infrastructure overview, and architectural decisions
- :material-file-document-edit: **[Design Plans](plans/index.md)**
---
Planning documents and design proposals
Cluster Overview¶
| Component | Technology |
|---|---|
| Orchestration | k3s (lightweight Kubernetes) |
| CNI | Calico |
| Secrets | HashiCorp Vault |
| SSO/Identity | Authentik |
| Observability | Grafana + VictoriaMetrics |
| GitOps | ArgoCD |
| Automation | Windmill + HCP Terraform |
Repository Structure¶
selfhosted-cluster/
├── ansible/ # Cluster deployment, node configuration
├── tf/ # Infrastructure configuration (Terraform)
├── argocd/ # Kubernetes manifests (GitOps)
├── windmill/ # Automation flows
└── docs/ # This documentation