🏠 Homelab Documentation¶
Hardware: Beelink Mini PC
Hypervisor: Proxmox VE
Architecture¶
graph TD
Internet --> Cloudflare
Cloudflare --> Tunnel[Cloudflare Tunnel]
Tunnel --> NPM[Nginx Proxy Manager]
NPM --> HA[Home Assistant]
NPM --> Paperless[Paperless]
NPM --> Tandoor[Tandoor]
Clients[LAN Clients] --> AdGuard
AdGuard --> Unbound
AdGuard --> NPM
🖥 Infrastructure¶
🖥 Services¶
🖥 Operations¶
- Backup Strategy
- Restore Guide
- Disaster Recovery
- Terminal Cheat Sheet
- Updating Services
- Maintenance Procedure
- Proxmox Maintenance
- Network Troubleshooting
🖥 Runbooks¶
🖥 URL Overview¶
🖥 Quick Links¶
Internal Services¶
| Service | URL |
|---|---|
| Proxmox | proxmox.home |
| Homepage | homepage.home |
| Paperless | paperless.home |
| Tandoor | rezepte.home |
| Portainer | portainer.home |
| Code Server | codeserver.home |
| Home Assistant | ha.home |
| AdGuard | adguard.home |
External¶
| Service | URL |
|---|---|
| Home Assistant | ha.salassi.de |
| Paperless | paperless.salassi.de |
| Tandoor | rezepte.salassi.de |
Notes¶
• No public router ports required for exposed services
• External access is handled through Cloudflare Tunnel
• Internal DNS is handled by AdGuard with DNS rewrites
• Admin services remain internal-only or VPN-only