Skip to content

HomeLab Documentation

Welcome to the technical documentation for Dan's homelab infrastructure. This site provides comprehensive documentation for the design, implementation, and operation of a hybrid cloud-native homelab environment.

Overview

This homelab implements a modern, cloud-native infrastructure stack using:

  • Virtualization: Proxmox VE on enterprise Dell PowerEdge servers
  • Container Orchestration: Kubernetes running on Talos Linux
  • GitOps: FluxCD for declarative application management
  • Storage: Multi-tier storage with Ceph, NFS, and cloud backup integration
  • Networking: Enterprise Cisco switching with VLAN segmentation
  • Monitoring: Prometheus, Grafana, and comprehensive observability

Architecture Highlights

Current Status (October 2025)

Minimal Cluster Deployment (Emergency rebuild following Ceph failure)

  • 3-node Kubernetes cluster (Talos Linux 1.8.3, K8s 1.31.1)
  • Running on emerald (Dell R720XD): 32 cores, 160GB RAM total
  • GitOps with FluxCD managing all workloads
  • External NFS storage (apollo server) + MetalLB LoadBalancer
  • Critical applications operational (Vaultwarden password manager)
  • See Minimal Cluster Deployment Status

Planned Evolution

  • Phase 2: Multi-node cluster expansion with fuji server
  • Phase 3: Full high-availability cluster with 5 Dell servers
  • Hybrid Cloud: Oracle Cloud Free Tier integration for DR and burst capacity

Quick Navigation

Section Description
Architecture System design and infrastructure architecture
Planning Current priorities and future roadmap
Infrastructure Core infrastructure services and strategies
Operations Operational procedures and incident reports
Reference Hardware specs, configurations, and reference materials

Key Repositories

This documentation site aggregates information from several focused repositories:

  • infra-talos: Infrastructure as Code for VM provisioning and Kubernetes bootstrapping
  • flux-repo: GitOps repository for Kubernetes workload management
  • homelab-docs: This documentation site

Getting Started

If you're new to this homelab setup, start with:

  1. Architecture Overview - Understand the overall system design
  2. Network Architecture - Learn about network segmentation and VLANs
  3. Application Priorities - See what's currently being deployed
  4. Hardware Inventory - Review the physical infrastructure

This documentation is automatically generated from the main branch and updated on every commit