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.

Quick Navigation

• Getting Started

---

Environment setup, cluster access, and AI tooling configuration

• Operations

---

Day-to-day operational guides for Vault, Authentik, Cloudflare, and more

• Reference

---

Technical reference for services, technologies, networking, and secrets

• Architecture

---

System design, infrastructure overview, and architectural decisions

• Design Plans

---

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	Temporal + HCP Terraform

Repository Structure

selfhosted-cluster/
├── ansible/     # Cluster deployment, node configuration
├── tf/          # Infrastructure configuration (Terraform)
├── argocd/      # Kubernetes manifests (GitOps)
└── docs/        # This documentation