Ragas Homelab Documentation

Welcome to the comprehensive documentation for the Ragas Homelab Kubernetes cluster.

Quick Links

Resource	URL	Description
Kubernetes Dashboard	https://k8s.ragas.cc	Cluster management
Homepage	https://home.ragas.cc	Service dashboard
Grafana	https://grafana.ragas.cc	Monitoring & metrics
Docs	https://docs.ragas.cc	This documentation

Architecture Overview

• Platform: Talos Linux v1.11.5
• Kubernetes: v1.34.2
• GitOps: Flux v2.7.5
• CNI: Cilium (eBPF, DSR mode)
• Ingress: Envoy Gateway (Gateway API)
• Certificates: cert-manager + Let's Encrypt

Cluster Nodes

Node	Role	IP	Resources
talos-cp-1	Control Plane	172.16.1.50	4 CPU, 8GB RAM, 100GB
talos-cp-2	Control Plane	172.16.1.51	4 CPU, 8GB RAM, 100GB
talos-cp-3	Control Plane	172.16.1.52	4 CPU, 8GB RAM, 100GB
talos-worker-1	Worker	172.16.1.53	8 CPU, 16GB RAM, 200GB

Cluster VIP: 172.16.1.49

Documentation Sections

Architecture

• Cluster Design
• Network Architecture
• Storage
• Security

Services

• Homepage Dashboard
• Monitoring Stack
• Certificate Management
• DNS & Ingress

Guides

• Deploying a New Service
• Adding a New Node
• Backup & Restore
• Upgrading Talos
• Upgrading Kubernetes

Runbooks

• Node Failure
• Certificate Issues
• Storage Problems
• Network Troubleshooting

Repository Structure

k3s-homelab/
├── docs/                    # This documentation
├── kubernetes/
│   ├── apps/               # Application deployments
│   │   ├── cert-manager/   # TLS certificates
│   │   ├── default/        # Default namespace apps
│   │   ├── flux-system/    # GitOps components
│   │   ├── kube-system/    # Core cluster services
│   │   ├── monitoring/     # Prometheus, Grafana
│   │   └── network/        # Ingress, DNS
│   ├── components/         # Shared Kustomize components
│   └── flux/              # Flux configuration
├── talos/                  # Talos machine configs
├── bootstrap/              # Initial cluster setup
└── templates/              # Config generation templates

Getting Started

1. Access the cluster:

   export KUBECONFIG=/path/to/kubeconfig
   kubectl get nodes
   

2. View running services:

   kubectl get pods -A
   flux get ks -A
   

3. Deploy a change:

   git add -A
   git commit -m "feat: add new service"
   git push
   # Flux will automatically reconcile
   

Support

• Repository: https://github.com/sagaragas/k3s-homelab
• Infrastructure: https://github.com/sagaragas/homelab-iac