Skip to content
fzymgc-house Cluster Docs

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

Section titled “Quick Navigation”
  • Getting Started — Environment setup, cluster access, and AI tooling configuration
  • Operations — Day-to-day operational guides for Vault, Keycloak, Cloudflare, and more
  • Reference — Technical reference for services, technologies, networking, and secrets
  • Architecture — System design, infrastructure overview, and architectural decisions
  • Engineering — Design specs and implementation plans behind cluster changes

Cluster Overview

Section titled “Cluster Overview”
ComponentTechnology
Orchestrationk3s (lightweight Kubernetes)
CNICilium (with Hubble observability)
SecretsHashiCorp Vault
SSO/IdentityKeycloak
ObservabilityGrafana + VictoriaMetrics
GitOpsArgoCD
AutomationTemporal + HCP Terraform

Repository Structure

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