Infrastruktur-Dokumentation (privat)

Zentrale Dokumentation für die Proxmox-Umgebung jeanavril.

Git: https://git.jeanavril.com/jean/docu.git

Hosts

Host	IP (Management)	Rolle	Doku
pve1	192.168.10.5	Primärer Proxmox, Fallback-OPNsense	pve1/
pve2	192.168.10.4	Produktions-Proxmox, Router, GPU-Compute	pve2/

DNS intern: *.iot → VLAN 40 (z. B. homeassistant.iot → 192.168.40.254)

Verzeichnis

docu/
├── README.md                 ← diese Datei
├── guests/                   ← Compose & Stack-Config pro VM/CT (ohne Daten)
├── migration/                ← Schritt-für-Schritt Updates & Tuning
├── shared/                   ← übergreifend (MQTT, Git, Netzwerk)
├── pve1/                     ← nur pve1
└── pve2/                     ← nur pve2

Shared (beide Hosts)

Datei	Inhalt
shared/infrastruktur-netzwerk.md	VLANs, IPs, Bridges
shared/opnsense-docker-subnet-routing.md	How-To: Docker-Subnetz über OPNsense erreichbar machen
shared/mqtt-homeassistant.md	MQTT-Broker, HA Discovery, Credentials
shared/git-und-repos.md	Gitea, Tokens, Clone-Pfade
migration/nextcloud-optimierung-und-updates.md	Nextcloud VM 101: Updates, Tuning, notify_push
guests/	Docker-Stacks pro Gast (Compose, ohne Volumes/Daten)
guests/vm101-ubuntu/docbr0-opnsense-routing.md	VM 101: docbr0 Instanz
shared/opnsense-docker-subnet-routing.md	How-To: Docker-Subnetz über OPNsense

Code-Repos (separat von dieser Doku)

Repo	URL	Inhalt
server-power	https://git.jeanavril.com/jean/server-power.git	Go-Agent pve-power-mqtt
docu	https://git.jeanavril.com/jean/docu.git	Diese Dokumentation

Auf einem Host bearbeiten & pushen

cd /root/docu
git pull
# Dateien unter pve1/ oder pve2/ editieren
git add -A && git commit -m "Beschreibung" && git push

Clone-Pfad auf beiden Nodes: /root/docu

Schnellreferenz Power-Monitoring

systemctl status pve-power-mqtt nvidia-persistenced   # nur pve2 GPU
journalctl -u pve-power-mqtt -f

Stand: Juni 2026