🏠 Homelab Documentation

Hardware: Beelink Mini PC
Hypervisor: Proxmox VE

---

🧭 Quick Start

🚨 Emergency

• 👉 Disaster Recovery
• 👉 Full Rebuild
• 👉 Restore Script

🔁 Backup & Restore

• Backup Strategy
• Restore Guide
• Restore Script

---

🏗 Architecture

graph TD
    Internet --> Cloudflare
    Cloudflare --> Tunnel[Cloudflare Tunnel]
    Tunnel --> NPM[Nginx Proxy Manager]
    NPM --> HA[Home Assistant]
    NPM --> Paperless[Paperless]
    NPM --> Tandoor[Tandoor]
    NPM --> StirlingPDF[Stirling-PDF]

    Clients[LAN Clients] --> AdGuard
    AdGuard --> Unbound
    AdGuard --> NPM

---

🖥 Infrastructure

• Proxmox Overview
• Docker Host
• Network Layout
• DNS Architecture
• Container Inventory
• Disaster Flow

---

⚙️ Services

• AdGuard
• Cloudflare Tunnel
• Nginx Proxy Manager
• Home Assistant
• Paperless
• Tandoor
• Homepage Dashboard
• Stirling-PDF
• Jellyfin
• Nextcloud
• Calibre

---

🛠 Operations

• Backup Strategy
• Restore Guide
• Restore Script
• Disaster Recovery
• Full Rebuild
• One-Command Restore
• Proxmox Bootstrap

---

🔧 Maintenance & Troubleshooting

• Updates
• Maintenance
• Proxmox Maintenance
• Network Troubleshooting
• Terminal Cheat Sheet

---

📦 Runbooks

• Deploy new container
• Add new domain
• Shutdown Homelab

---

🌐 URLs

• Internal & External URLs

---

⚡ Quick Access

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
Nextcloud	cloud.slassi.de

---

🧠 Notes

• No public router ports required
• External access via Cloudflare Tunnel
• Internal DNS handled by AdGuard
• Admin services remain internal-only or VPN-only