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
  • Rook-Ceph - Cloud-native storage orchestration

  • Getting Started

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

    Get started

  • Operations

    Procedures for maintaining and upgrading cluster components.

    Operations guides

  • Storage

    Configure and manage persistent storage with Rook-Ceph.

    Storage setup

  • Reference

    Detailed reference documentation for cluster architecture and tools.

    Reference docs

Cluster Overview

Infrastructure

  • Control Plane Nodes: 2 nodes (control0, control1)
  • Worker Nodes: 3 nodes (worker0, worker1, worker2)
  • Network: 10.0.0.0/16 (nodes on 10.0.50.0/24)
  • CNI: Cilium with Gateway API
  • Storage: Rook-Ceph with dedicated disk partitions

Key Features

  • ✅ GitOps-driven - All configuration stored in Git
  • ✅ Highly Available - Multi-node control plane
  • ✅ Encrypted Secrets - SOPS with age encryption
  • ✅ External Access - Cloudflare Tunnel integration
  • ✅ Persistent Storage - Ceph block and filesystem storage
  • ✅ Automated Updates - Renovate for dependency management

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!