Homelab Adventures

Welcome to Homelab Adventures

This blog documents the journey of building and maintaining a home infrastructure - from Kubernetes clusters to self-hosted services, with AI assistance along the way.

The Stack

Compute: 3x Proxmox nodes running Kubernetes via Spectro Cloud

GitOps: ArgoCD managing 90+ applications

Key Services:

• Forgejo (Git hosting, 230+ repos)
• Harbor (container registry, 366 repositories)
• Nextcloud (personal cloud)
• Wiki.js (documentation)

Databases: CloudNativePG with Crossplane compositions

Observability: Prometheus, Grafana, Loki, Alertmanager

Topics You’ll Find Here

Infrastructure

• Kubernetes architecture and patterns
• Proxmox virtualization
• Networking and DNS (AdGuard, DNSControl)
• Storage and backups (Velero, Kopia, s3bkp)

Self-Hosted Services

• Running your own cloud services
• Container registry with Harbor
• Git hosting with Forgejo

Automation

• GitOps with ArgoCD
• CI/CD with Forgejo Actions
• kcl-ci workflow generator
• Renovate dependency management

Crossplane & IaC

• Database compositions (CNPG)
• Secret management with Infisical
• Harbor config-as-code

AI Integration

• Claude Code for development
• dot-ai MCP for K8s operations
• Custom prompts and workflows

Custom Solutions

• s3bkp - K8s-native PVC backups
• git-manager - TUI for repo management
• theme-api - Cross-device theme sync

Getting Started

Browse the documentation using the sidebar navigation, or use the search to find specific topics.