🏠 [kCn3333/homelab] Documentation

My personal infrastructure playground – where containers run wild and networking should just work smoothly ™

📚 What's This?

This repo contains my homelab documentation, configs, and infrastructure notes. Think of it as a digital garden where I document everything I learn while breaking and fixing things in my lab.

📖 Read the full documentation →

🟢 Check what is up →

🛠️ The Stack

Hardware

🖥️ Main Server (click to expand)

• 
  • CPU: Intel Silver J5005 (4C/4T) Burst 2.80 GHz, Base 1.50 GHz, 4MB Cache, TDP 10 W
  • RAM: Samsung 16GB DDR4 2666Mhz
  • Storage:
    • 1x 256GB SSD M.2 SATA
    • 2x 1TB HDD 2,5" WD Blue
  • Network: 1GbE
  • OS: Debian 13

🔧 Cluster Nodes (x3)

• 
  • CPU: AMD GX-420GI (4C/4T), Burst 2.2 GHz, 15 W TDP
  • RAM: 8GB RAM
  • Storage: 128 SSD
• Purpose: Kubernetes worker nodes

🌐 Network

• 
  • Router: UniFi Cloud Gateway Ultra
  • Core Switch: Ubiquiti USW-Lite-8-PoE
  • WiFi: UniFi AP U6+, Ubiquiti Loco M2

🚀 Services Running

Core Infrastructure

---

Service	Role in Lab	Status
	Containerization & Runtime
	Network-wide Ad Blocking & DNS
	Reverse Proxy Management
	Secure Tunnels & DNS
	Zero-trust Network Access
	Auto-update Docker Containers

Applications

---

Application	Role in Lab	Status
	Docker Management GUI
	Workflow Automation
	Backup Solution
	Personal Cloud & Collaboration
	Self-hosted Git Service
	Password Manager (Bitwarden)

Monitoring

---

Application	Role in Lab
	Metrics Visualization
	Metrics Collection
	Service Uptime Monitoring

📝 Documentation Structure

📂 docs/
├── 📂 infrastructure/     # Server & network setup
├── 📂 provisioning        # Setup & System hardening
├── 📂 applications/       # App deploying & configurations
└── 📂 automation/         # Scripts & workflows

🎯 Goals

• Build a stable, production-ready homelab
• Learn container orchestration
• Implement proper monitoring
• Set up automated backups
• Migrate to Kubernetes
• Add CI/CD pipeline
• Implement GitOps workflow

🤝 Contributing

This is my personal documentation, but feel free to:

• Open issues if you spot errors
• Submit PRs for typos or improvements
• Fork for your own homelab setup

📜 License

MIT License - do whatever you want with this!

🔗 Links

• 📖 Full Documentation
• 💬 Discussions
• 🐛 Report Issues

---

Built with MkDocs Material • Hosted on GitHub Pages