Welcome to the Homelab Documentation

Explore Documentation View Source

Complete documentation for infrastructure, services, and operations

Infrastructure at a Glance

This homelab runs on Proxmox VE virtualization with a K3s Kubernetes cluster, providing a robust platform for self-hosted services. Storage is backed by TrueNAS with iSCSI integration.

Proxmox Cluster

2 nodes running Proxmox VE 8.x
prox1: 192.168.1.3
prox2: 192.168.1.2

K3s Kubernetes

2 Master nodes + 2 Worker nodes
Version: v1.28.5+k3s1
HA Control Plane

Storage Systems

TrueNAS: iSCSI targets
NFS: Shared storage
Multiple persistent volumes

Key Services Running

Infrastructure

  • ArgoCD (GitOps)
  • Cert Manager
  • MetalLB
  • NGINX Ingress
  • External DNS

Monitoring

  • Prometheus
  • Grafana
  • Various Exporters
  • Blackbox Monitoring

Applications

  • Home Assistant
  • Gitea
  • Harbor Registry
  • Vault
  • UniFi Controller