Infrastructure

Overview

The homelab infrastructure is built on enterprise-grade virtualization and container orchestration technologies, providing a reliable and scalable platform for self-hosted services.

Architecture Components

Virtualization Layer

• Platform: Proxmox VE 8.x
• Cluster: 2-node cluster with shared storage
• High Availability: VM migration and failover capabilities

Container Orchestration

• Platform: K3s (Lightweight Kubernetes)
• Architecture: 2 master nodes + 2 worker nodes
• Version: v1.28.5+k3s1

Storage Backend

• Primary: TrueNAS with iSCSI targets
• Secondary: NFS shares for bulk storage
• Persistent Volumes: Multiple storage classes for different workloads

Network Infrastructure

• Load Balancing: MetalLB for bare metal load balancing
• Ingress: NGINX Ingress Controller
• DNS: External-DNS with Cloudflare integration
• Service Mesh: Direct pod-to-pod communication

Infrastructure Map

┌─────────────────────────────────────────────────────────────┐
│                     Proxmox Cluster                          │
├─────────────────────────┬───────────────────────────────────┤
│      prox1 (192.168.1.3)│      prox2 (192.168.1.2)         │
│  ┌─────────────────┐    │  ┌─────────────────┐             │
│  │ k3s-master-01   │    │  │ k3s-worker-02   │             │
│  │ k3s-master-02   │    │  └─────────────────┘             │
│  │ k3s-worker-01   │    │                                   │
│  └─────────────────┘    │                                   │
└─────────────────────────┴───────────────────────────────────┘
                                    │
                          ┌─────────┴─────────┐
                          │ TrueNAS Storage   │
                          │ (192.168.1.6)     │
                          └───────────────────┘

Key Infrastructure Services

Proxmox Nodes

Kubernetes Nodes

Storage Systems