Skip to content

Home-Ops Documentation

Welcome to the home-ops cluster documentation! This site provides comprehensive guides for deploying and operating a Talos Linux-based Kubernetes cluster using GitOps principles.

About This Cluster

This is a home Kubernetes cluster built with:

  • Talos Linux - Immutable Kubernetes OS
  • Flux - GitOps continuous delivery
  • Cilium - Advanced networking and security

  • Getting Started

    New to this cluster? Start here to understand the architecture and initial setup.

    Get started

  • Reference

    Detailed reference documentation for cluster architecture and tools.

    Reference docs

Cluster Overview

Infrastructure

  • Control Plane Nodes: 2 nodes (control0, control1) - Talos v1.11.1
  • Worker Nodes: 3 nodes (worker0, worker1, worker2)
  • Kubernetes Version: v1.34.1
  • Network: Pod CIDR 10.42.0.0/16, Service CIDR 10.43.0.0/16
  • CNI: Cilium with Gateway API (internal & external gateways)
  • Storage: Rook-Ceph (block, filesystem, object), ZFS NFS provisioner
  • DNS: k8s-gateway for internal DNS resolution

Key Features

  • ✅ GitOps-driven - All configuration stored in Git, managed by Flux
  • ✅ Highly Available - Multi-node control plane with VIP
  • ✅ Encrypted Secrets - SOPS with age + External Secrets with 1Password
  • ✅ Dual Gateway - Internal (home network) & External (internet) access
  • ✅ Distributed Storage - Rook-Ceph cluster with block and filesystem support
  • ✅ Automated Updates - Renovate for dependency management
  • ✅ SSO Authentication - Pocket ID OIDC provider for unified login
  • ✅ Template-Driven - Configuration generation via makejinja

Contributing

This cluster follows a template-driven approach using makejinja. When making changes:

  1. Edit cluster.yaml or nodes.yaml for configuration
  2. Run task configure to regenerate manifests
  3. Commit and push - Flux handles deployment

See the architecture reference for more details.

Support

Based on cluster-template

This cluster is based on @onedr0p's cluster-template - an excellent starting point for home Kubernetes clusters!