# 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.3 | Primärer Proxmox, Fallback-OPNsense | [pve1/](pve1/) |
| **pve2** | 192.168.10.4 | Produktions-Proxmox, Router, GPU-Compute | [pve2/](pve2/) |

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

## Verzeichnis

```
docu/
├── README.md                 ← diese Datei
├── shared/                   ← übergreifend (MQTT, Git, Netzwerk)
├── pve1/                     ← nur pve1
└── pve2/                     ← nur pve2
```

## Shared (beide Hosts)

| Datei | Inhalt |
|-------|--------|
| [shared/infrastruktur-netzwerk.md](shared/infrastruktur-netzwerk.md) | VLANs, IPs, Bridges |
| [shared/mqtt-homeassistant.md](shared/mqtt-homeassistant.md) | MQTT-Broker, HA Discovery, Credentials |
| [shared/git-und-repos.md](shared/git-und-repos.md) | Gitea, Tokens, Clone-Pfade |

## 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

```bash
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

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

Stand: Juni 2026