This repository is my home Kubernetes cluster in a declarative state. Flux watches the kubernetes folder and will make the changes to the cluster based on the YAML manifests.
Core components that form the foundation of the cluster:
- authelia/authelia: SSO and two-factor authentication in front of internal apps, with lldap/lldap as the user directory.
- backube/volsync: Backup and recovery of persistent volume claims.
- cilium/cilium: Kubernetes CNI.
- cloudnative-pg/cloudnative-pg: High-availability PostgreSQL for apps that need a database.
- dragonflydb/dragonfly: Redis-compatible in-memory store for caches, sessions and queues.
- envoyproxy/envoy: Kubernetes-based application gateway using Kubernetes Gateway API, split into an internal (Authelia-protected) and an external gateway.
- external-secrets/external-secrets: Managed Kubernetes secrets using 1Password Connect.
- home-operations/tuppr: Handles Kubernetes and Talos upgrades automatically.
- jetstack/cert-manager: Creates SSL certificates for services in my Kubernetes cluster.
- kubernetes-sigs/external-dns: Automatically manages DNS records from my cluster in CloudFlare.
- rook/rook: Distributed block storage for persistent storage.
- siderolabs/talos: The Kubernetes Operating System.
For observability and monitoring of the cluster the following software is used:
- fluent/fluent-bit: Log processor.
- grafana/grafana: Data visualization platform.
- prometheus/alertmanager: Handles processing and sending alerts.
- pushover: Handles receiving alerts on my devices.
- TwiN/gatus: High level status dashboard.
- VictoriaMetrics/VictoriaLogs: Database for logs.
- prometheus/prometheus: Time series database for metrics.
Self-hosted AI services, backed by hosted models rather than local GPUs:
- anthropics/claude-code: In-cluster Remote Control server, so I can fix the cluster from claude.ai/code or the Claude app. Tools outside the repo allowlist wait for my approval.
- BerriAI/litellm: OpenAI-compatible LLM proxy, managed by home-operations/litellm-operator and routing to OpenRouter.
- eleboucher/memini: Persistent memory for AI agents.
- huggingface/text-embeddings-inference: In-cluster embedding model server.
- Github Actions: every pull request and Renovate branch is built with flate, the rendered diff is risk-assessed before Renovate is allowed to automerge, and new images are pre-pulled onto the nodes
- Renovate keeps the application charts and container images up-to-date
- 1Password for managing secrets via external-secrets.
- AWS SES for sending emails.
- Cloudflare tunnels for exposing services & creating certificates & managing domains.
- Cloudflare R2 for daily backups.
- OpenRouter for hosted LLM inference.
- Pushover for sending alerts.
Total cloud costs yearly is approximately ~$150/year.
This Git repository contains the following directories.
π bootstrap # Resources to bootstrap the cluster
π docs # Docs
π kubernetes # Kubernetes cluster defined as code
ββπ flux # Main Flux configuration of repository
ββπ components # Flux components
ββπ apps # Apps deployed into my cluster grouped by namespace
π talos # Contains the configuration for Talos operating system
π terraform # Contains Cloudflare terraform| Device | Count | OS Disk Size | Data Disk Size | Ram | Operating System | Purpose |
|---|---|---|---|---|---|---|
| UDM-Pro-Max | 1 | - | - | - | UniFi | Router |
| USW-Pro-Aggregation | 1 | - | - | - | UniFi | Switch |
| USW-Pro-Max-24-PoE | 1 | - | - | - | UniFi | Switch |
| UAP-AC-Lite | 1 | - | - | - | UniFi | WiFi AP |
| ER-10X | 1 | - | - | - | EdgeOS | Switch |
| PiKVM V4 Mini | 1 | - | - | - | PiKVM | KVM |
| TESmart HDMI KVM Switch 8 Ports | 1 | - | - | - | - | KVM Switch |
| CyberPower CP1500PFCRM2U | 1 | - | - | - | UPS | |
| USP-PDU-Pro | 1 | - | - | - | UniFi | PDU |
| UNAS Pro 8 | 1 | - | 4x28TB | - | UniFi OS | NAS |
| MS-01 i9-13900H | 3 | 1TB | 2TB | 96GB | Talos | Control Plane |
Thanks to all the people who donate their time to the Kubernetes @Home community.
This repository was built off the onedr0p/cluster-template repository.
See LICENSE

