2.5 KiB
2.5 KiB
Homelab Wiki
Documentation for a self-hosted homelab running entirely on Docker Compose. This wiki covers the why behind each service, how they're configured, and what I learned running them — the repo itself has the raw docker-compose.yml files.
Contents
- Architecture and Hardware
- Monitoring Stack
- Alerting
- K3s
- Network Services
- Media Automation
- Workflow Automation
- Storage Health
- Lessons Learned
- AI Coding Agent
- Reverse Proxy (historical — Nginx Proxy Manager)
- Traefik (current reverse proxy)
- Vaultwarden (password manager)
- Nexus (Docker registry & artifact repository)
- Semaphore
- DockScope
- Ansible Playbooks
- GitLab CI/CD
- Custom CI Runner Images
- Voting App — Mono-Repo
- Elastic Stack (ELK) — Lab
At a glance
| Host | Ubuntu Server |
| Orchestration | Docker Compose, one stack per service |
| Management | Portainer, DockScope (3D visual dashboard) |
| Monitoring | Prometheus + Grafana + cAdvisor + node-exporter + Loki + Alloy (centralized logs) + Grafana Alerting (provisioned rules + email notifications) |
| Network | Pi-hole (DNS filtering), Samba (file sharing), Traefik (reverse proxy, config-as-code) |
| Automation | n8n + Semaphore (Ansible Web UI) + Ansible (update playbooks) |
| Disk health | Hard Disk Sentinel |
| AI Agent | OpenHands + Ollama |
| Registry | Nexus3 (Docker Hub pull-through cache + artifact repo) |
| Passwords | Vaultwarden (Bitwarden-compatible, 30+ char passwords) |
| CI/CD | Self-hosted GitLab (Omnibus) + Docker-executor Runner |
| Orchestration (K8s) | Single-node K3s cluster, monitored via the same Prometheus/Grafana/Loki stack |
This is a running system, not a demo — screenshots throughout this wiki are from the live dashboards.
Not everything in this repo runs permanently — see Elastic Stack (ELK) — Lab for a compose stack kept as a reference from a one-off learning exercise, not part of the always-on services above.