Skip to content

HomeLab Wiki

Welcome to the HomeLab Infrastructure documentation. This wiki covers the complete Kubernetes-based homelab setup including monitoring, applications, databases, and security.

Category Description
Architecture System design and topology
Kubernetes K3s cluster configuration
Monitoring Prometheus, Grafana, ELK Stack
Applications Deployed applications
Databases Data storage systems
Security Threat intelligence and logging
Operations GitOps and tunnels

Infrastructure Overview

graph TB
    subgraph Internet
        CF[Cloudflare]
    end

    subgraph HomeLab
        subgraph K3s Cluster
            Master[Master Node]
            Worker1[Worker 1]
            Worker2[Worker 2]
            Worker3[Worker 3]
            Worker4[Worker 4]
            Worker5[Worker 5<br/>Nextcloud Dedicated]
        end

        subgraph Storage
            Longhorn[Longhorn CSI]
        end
    end

    CF -->|Tunnel| Master
    Master --> Worker1
    Master --> Worker2
    Master --> Worker3
    Master --> Worker4
    Master --> Worker5
    Worker1 --> Longhorn
    Worker2 --> Longhorn
    Worker3 --> Longhorn
    Worker4 --> Longhorn
    Worker5 --> Longhorn

Key Technologies

  • Orchestration: K3s (Lightweight Kubernetes)
  • GitOps: ArgoCD
  • Ingress: Cloudflare Tunnel (Zero Trust)
  • Storage: Longhorn CSI
  • Monitoring: Prometheus + Grafana
  • Logging: Elasticsearch + Kibana + Elastic Agent
  • Alerting: Alertmanager + Discord Webhooks
  • Databases: InfluxDB, MongoDB, MySQL, Elasticsearch
  • Email: Microsoft Graph OAuth2 SMTP Relay

External Access

All services are exposed via Cloudflare Tunnel with zero-trust networking:

Service URL Description
Hub ajandrews.pro Main website & navigation
Family Cloud cloud.ajandrews.pro Nextcloud file storage
Wiki wiki.ajandrews.pro This documentation
Grafana grafana.ajandrews.pro Metrics dashboards
Kibana kibana.ajandrews.pro Log analysis
InfluxDB influxdb.ajandrews.pro Time-series database
ArgoCD argocd.ajandrews.pro GitOps dashboard
D&D dnd.ajandrews.pro Foundry VTT
Palworld palworld.ajandrews.pro:8211 Palworld game server (UDP)
Status status.ajandrews.pro Service health dashboard

Demo Access

Demo accounts are available for testing:

  • Username: DemoUser
  • Password: DemoUser

Documentation for HomeLab Infrastructure