Homelab Master-Doku

📚 Doku-Bibliothek 📄 PDF

✓ TODOs & offene Aufgaben 📄 PDF

📝 Changelog 📄 PDF

📊 Versionen & Update-Status 📄 PDF

🌐 IPs & Hosts 📄 PDF

Physische Hosts & Infrastruktur

VMs & LXCs auf scpve (.8)

VMs & LXCs auf pveforum (.192)

Hinweis: Detail-Inventur von pveforum noch nicht vollständig dokumentiert — siehe Original-Dokus.

Subdomains & öffentliche Dienste

🗺️ Infrastruktur-Karte 📄 PDF

🛠️ Wie mache ich…? 📄 PDF

SSH-Zugriff

# Vom Mac (bigbrain@MacBook-Pro-von-Steffen) per ed25519-Key:
ssh root@192.168.178.8           # scpve (Haupt-Proxmox)
ssh root@192.168.178.192         # pveforum
ssh bigbrain@192.168.178.131     # Docker-Host LXC 133
ssh bigbrain@192.168.178.121     # CoolDB-VM (alias: catta-DB)
ssh root@192.168.178.122         # Webserver-VM

LXC anlegen, starten, stoppen, löschen

# Liste aller LXCs
pct list

# LXC starten / stoppen
pct start <ID>
pct stop  <ID>
pct shutdown <ID>

# In LXC reingehen
pct enter <ID>          # direkt rein (root)
pct exec  <ID> -- <cmd> # einen Befehl ausführen

# Aus Template klonen (LXC 120 ist Debian-13-Template)
pct clone 120 <NEUE-ID> --hostname neuer-name --full

# Endgültig löschen
pct destroy <ID>

VM anlegen, starten, stoppen

qm list                  # alle VMs
qm start <ID>
qm shutdown <ID>
qm stop <ID>             # hart!
qm destroy <ID>           # löschen

Docker-Stacks auf LXC 133 verwalten

Alle Stacks liegen unter /opt/stacks/. Dockge ist die GUI dafür auf :5001.

ssh bigbrain@192.168.178.131
cd /opt/stacks/<stack-name>
docker compose ps                         # Status
docker compose logs -f                    # Logs live
docker compose pull && docker compose up -d   # Update
docker compose down                       # Stoppen
docker compose up -d                      # (neu) starten

Neue Website / Subdomain anlegen (5 Schritte, ~10 min)

1. App vorbereiten auf VM .122 (Verzeichnis, DB, config.php, Apache-Site)
2. DNS-Record bei ipv64 anlegen (A-Record mit Präfix)
3. DNS-Update-URL ins Cron-Skript auf VM .132 eintragen
4. NPM Proxy Host auf .131:81 mit Let's-Encrypt-SSL anlegen
5. Im Browser testen: https://meinedienst.rusti.ipv64.net

Detaillierte Anleitung mit allen Befehlen: ⚡ Interaktiver Spickzettel 📄 Webserver-Doku

Logs lesen — wo ist was?

Backup-Status prüfen

# Proxmox-Host: letzte Backups
ls -lh /var/lib/vz/dump/                                    # lokales Backup
ls -lh /mnt/pve/<synology-mount>/dump/                       # auf Synology

# CoolDB-VM: Restic-Snapshots in pCloud
ssh bigbrain@catta-DB
sudo -E restic -r rclone:pcloud:Backups/CoolDB-Catta-Restic snapshots

🔄 Updates 📄 PDF

Proxmox-Host Updates

Vorbereitung (immer!)

1. Snapshots der wichtigsten VMs/LXCs anlegen (mind. LXC 133, VM 121, VM 122, LXC 124)
2. Wartungsfenster ankündigen — alle laufenden Sessions schließen
3. Pending-Updates prüfen: apt list --upgradable 2>/dev/null | wc -l
4. Schauen ob ein Kernel-Update dabei ist → dann ist Reboot Pflicht:

   apt list --upgradable 2>/dev/null | grep -E 'proxmox-kernel|pve-kernel|linux-image'

Update durchführen

# Auf dem jeweiligen Host
ssh root@192.168.178.8    # oder .192

apt update
apt list --upgradable    # Letzter Blick was kommt
apt dist-upgrade -y      # WICHTIG: dist-upgrade, nicht nur upgrade

# Nach Kernel-Update: reboot
reboot

Nach dem Update prüfen

pveversion -v             # Version + Kernel
pct list                  # LXCs alle wieder hochgekommen?
qm list                   # VMs alle wieder hochgekommen?
systemctl status pve-cluster pvedaemon pveproxy pvestatd

Major-Upgrade Proxmox VE 8 → 9

Falls noch jemals nötig: Der komplette Pfad ist in der Original-Doku dokumentiert. Kernpunkte:

• Alle VMs/LXCs vorher sichern
• System komplett auf 8.4.x aktuell bringen
• pve8to9-Check fahren — alle Warnungen abarbeiten
• Repos auf trixie umstellen
• apt dist-upgrade → Reboot

📂 Komplette Upgrade-Doku öffnen

VM/LXC Updates (Debian/Ubuntu)

# In den Container/VM einsteigen
ssh root@<ip>     # oder pct enter <id>

apt update
apt dist-upgrade -y
apt autoremove -y
apt autoclean

# Reboot wenn neuer Kernel (bei VMs) oder bei systemd/glibc-Updates
reboot

Docker-Container / Stacks updaten

Variante 1: Per Stack über die Shell (LXC 133)

ssh bigbrain@192.168.178.131
cd /opt/stacks/nginx-proxymanager    # oder /dockge, /crowdsec, ...
docker compose pull
docker compose up -d
docker compose ps                     # Status prüfen
docker image prune -f                 # alte Images aufräumen

Variante 2: Per Dockge-GUI

Browser → http://192.168.178.131:5001 → Stack auswählen → Update. Dockge zeigt Pull + Restart live.

Update-Reihenfolge der Docker-Stacks

1. CrowdSec (Security zuerst — neue Patterns/CVEs)
2. MariaDB-Aria (vorsichtig: Backup vorher!)
3. nginx-proxy-manager (kurz erreichbar nicht — Reverse Proxy!)
4. Dockge (zuletzt — egal wenn kurz weg)

docker exec mariadb-aria mysqldump -uroot -p<pw> --all-databases > backup-$(date +%F).sql

Update-Erinnerungen (Empfehlung)

💾 Backups & Restore 📄 PDF

Wo liegen die Sicherungen?

Wer macht was?

Proxmox-Backup-Jobs

In Datacenter → Backup definiert. Pro Host ein Job, Ziel: lokales Storage + Synology-Mount.

# Auf dem Host: vzdump manuell
vzdump <id> --mode snapshot --storage backup-lokal-sata --compress zstd

# Backup-Konfiguration ansehen
cat /etc/pve/jobs.cfg

Host-Config-Backup (Proxmox selbst)

Eigenes Skript sichert /etc/pve/, /etc/network/, /root/ etc. nach DSSEC. Details + Skript-Code siehe Original-Doku.

App-Daten der CoolDB (VM 121)

Eigener Restic-Backup-Pfad (unabhängig vom Proxmox-Backup):

/usr/local/bin/cooldb-backup.sh       # Backup-Skript (täglich 03:00 via cron.d)
/usr/local/bin/cooldb-bak-rotate.sh   # Rotation
/root/.restic-password                # Restic-Passwort
/root/.config/rclone/rclone.conf      # pCloud-Token

# Restic-Repo
rclone:pcloud:Backups/CoolDB-Catta-Restic

Sync-Skript DSSEC → pCloud

Auf der Synology läuft ein Aufgabenplaner-Job, der per rclone alle Backups nach pCloud spiegelt. Pfad und Quellcode siehe Original-Doku.

Backups prüfen — täglich/wöchentlich

Schnellcheck (5 Min wöchentlich)

# Auf jedem Proxmox-Host
ls -lh /var/lib/vz/dump/ | tail -10               # neueste Backups
ls -lh /mnt/pve/<synology-mount>/dump/ | tail -10  # auf Synology
journalctl -u vzdump --since "1 week ago" | grep -E "ERROR|FAIL"

# Restic auf VM 121
ssh bigbrain@catta-DB
sudo -E restic -r rclone:pcloud:Backups/CoolDB-Catta-Restic snapshots | tail -5
sudo -E restic -r rclone:pcloud:Backups/CoolDB-Catta-Restic check

Restore-Test (monatlich)

1. Eine VM/LXC aus Backup als neue ID wiederherstellen (nicht überschreiben!)
2. Test-VM hochfahren, prüfen ob Dienst läuft
3. Wieder löschen

Restore-Szenarien

Szenario A — Einzelne VM/LXC zurückspielen

# In Proxmox-GUI:
#   Storage (backup-lokal-sata / synology) → Backups → Eintrag wählen → Restore
#   ⚠ Bei "Restore as new VM" andere ID wählen, sonst wird das Original überschrieben

# Per CLI:
qmrestore  /var/lib/vz/dump/vzdump-qemu-121-...vma.zst <neue-id>     # für VMs
pct restore <neue-id> /var/lib/vz/dump/vzdump-lxc-133-...tar.zst    # für LXCs

Szenario B — Aus pCloud restoren (Synology kaputt)

Backup-Pakete erst per rclone copy von pCloud auf einen Proxmox-Host kopieren, dann wie Szenario A.

Szenario C — Kompletter Proxmox-Host neu

1. Proxmox VE 9.x von ISO neu installieren
2. Storages neu einbinden (Synology-SMB, ZFS-POOL1)
3. Host-Config-Backup zurückspielen (/etc/pve/, Netzwerk, etc.)
4. VMs/LXCs einzeln aus Backup restoren

Szenario D — CoolDB-VM komplett verloren

Komplette Schritt-für-Schritt-Anleitung in der separaten Recovery-Doku (Recovery.html). Voraussetzung: Recovery-Bundle mit rclone.conf, .restic-password, Skripten, msmtprc auf USB-Stick.

🖥️ Proxmox-Hosts 📄 PDF

📦 VMs & LXCs im Detail 📄 PDF

/etc/cron.d/ipv64-update      # Cron-Job
/usr/local/bin/ipv64-update.sh # Update-Skript
/var/log/ipv64-update.log     # Log

🐳 Docker-Stacks auf LXC 133 📄 PDF

Bind-Mounts NPM

/data/compose/4/data         # NPM-Konfiguration
/data/compose/4/letsencrypt  # SSL-Zertifikate
/data/compose/4/mysql        # MariaDB-Daten

Bewusst NICHT übernommen aus alter Migration

• Portainer — durch Dockge ersetzt
• Drawio — nicht mehr genutzt

Bei Bedarf einfach neue Stacks unter /opt/stacks/ anlegen.

🛡️ Security 📄 PDF

CrowdSec Setup

• Engine: Docker-Container auf LXC 133, API auf 127.0.0.1:8080
• Collections: linux, sshd, nginx, nginx-proxy-manager, http-cve
• Bouncer: iptables-bouncer v0.0.34 am Host (nicht im Container — von GitHub-Release, kein apt-Paket in Trixie)
• NPM-Bouncer verworfen: Lua-Lib fehlt im NPM-Image

Wichtige Befehle

# Auf LXC 133:
docker exec crowdsec cscli decisions list    # Aktive Bans
docker exec crowdsec cscli alerts list       # Alert-Historie
docker exec crowdsec cscli collections list  # Installierte Collections
docker exec crowdsec cscli metrics           # Engine-Metriken

# iptables-Bans am Host prüfen
iptables -L CROWDSEC_CHAIN -n | head -20

Firewall-Regeln (UFW auf VM 121)

sudo ufw status verbose
# Erwartung:
#   80/tcp     ALLOW IN  Anywhere
#   443        ALLOW IN  Anywhere
#   22/tcp     ALLOW IN  192.168.178.0/24    ← SSH nur aus LAN!

🚑 Troubleshooting 📄 PDF

"VM/LXC startet nicht"

# Status checken
pct status <id>      # für LXC
qm status <id>        # für VM

# Detail-Log
journalctl -u pve-container@<id> -n 50
qm showcmd <id>      # gibt KVM-Kommandozeile aus

# Häufige Ursachen:
# 1. Storage voll → df -h
# 2. Snapshot blockiert → qm/pct listsnapshot
# 3. RAM überbucht → cat /proc/meminfo
# 4. Lock-File → /var/lock/qemu-server/lock-<id>.conf entfernen (vorsichtig!)

"Subdomain nicht erreichbar (502 oder Connection refused)"

1. NPM-Status prüfen: http://.131:81 → Stream-Status
2. Backend-Erreichbarkeit von LXC 133 aus: curl -I http://192.168.178.122/
3. Apache/nginx-Log auf Backend-VM: tail -30 /var/log/apache2/error.log
4. DNS-Update auf .132: tail -20 /var/log/ipv64-update.log
5. CrowdSec ban? docker exec crowdsec cscli decisions list | grep <ip>

"Backup fehlgeschlagen"

# Proxmox-Backup-Log
cat /var/log/vzdump/<id>-<date>.log

# Storage voll?
df -h
zpool list                 # auf scpve

# Snapshot hängt? 
zfs list -t snapshot | grep <id>

# Synology nicht erreichbar?
mount | grep synology
ping 192.168.178.3

"CoolDB: Anhänge laden nicht"

Meist max_allowed_packet zu klein:

sudo mysql -e "SHOW VARIABLES LIKE 'max_allowed_packet';"
# Sollwert: 134217728  (= 128 MB)
# Falls weniger: /etc/mysql/mariadb.conf.d/50-server.cnf prüfen + restart

"CoolDB: Mail kommt nicht an"

echo "test $(date)" | msmtp deine@mail
# Bei Fehler: /etc/msmtprc prüfen (Permissions 640, owner root:msmtp)

"rclone/Restic: Invalid access_token"

# pCloud-Token abgelaufen — neu generieren
sudo rclone config reconnect pcloud:

"NPM-Update kaputt — kein Web-UI mehr"

cd /opt/stacks/nginx-proxymanager
docker compose logs nginx-proxy-manager | tail -50
docker compose down
docker compose up -d
# Im Notfall: vorherige Version festsetzen in docker-compose.yml

"Proxmox-Update: Reboot, aber VMs starten nicht"

1. systemctl status pve-cluster pveproxy pvedaemon pvestatd
2. Storage-Mounts prüfen: pvesm status
3. ZFS-Pool: zpool status
4. Auto-Start verfügbar: cat /etc/pve/qemu-server/<id>.conf | grep onboot

📖 Glossar 📄 PDF

📚 Original-Dokus · Direkt-Übersicht 📄 PDF

Alle 17 Dokus liegen auf dem Server unter docs/. Die übersichtliche Auswahl mit Filterung, Tags und "Wann brauchst du das?"-Hinweisen findest du in der Doku-Bibliothek. Unten die schnelle Direkt-Übersicht: