wiki.no-br.de

Eine ältere Version des Dokuments wurde geladen! Beim Speichern wird eine neue Version des Dokuments mit diesem Inhalt erstellt.

====== Proxmox-Server pve ======

[[:start|← Heimnetz-Übersicht]] · [[ha:raderbroich:start|Home Assistant Raderbroich]]

Stand: **25.09.2026**

===== Überblick =====

===== Gäste auf dem Server =====

**⚠️ Wichtig:** Home Assistant läuft selbst als VM auf diesem Proxmox. Ein Neustart des Proxmox-Servers startet also auch Home Assistant neu. Fällt der Proxmox-Server aus, kann Home Assistant keine Meldung mehr senden – dann greift nur die Ausfallerkennung nach dem Neustart (siehe [[ha:raderbroich:logik:automationen|Automationen]], „HA-Lebenszeichen“).

===== Anbindung an Home Assistant =====

* Integration: **Proxmox VE** (Home-Assistant-Core, Domain ''proxmoxve''), eingerichtet am 25.09.2026
  * Anmeldung per **API-Token** (Realm ''pam'', Benutzer ''root'', SSL-Prüfung aus, Port 8006)
  * Das Token hat „Privilege Separation“ und braucht deshalb eine **eigene Berechtigung**:
    * Proxmox → Datacenter → Permissions → Add → **API Token Permission**
    * Pfad ''/'', Rolle **PVEAuditor** (nur lesen), „Propagate“ an
    * Ohne diese Berechtigung liefert die Integration nur „online“ und keine Werte (so war es bei der Ersteinrichtung).
  * Für die Neustart-/Start-/Snapshot-Knöpfe braucht das Token zusätzlich Schreibrechte (z. B. Rolle ''PVEVMAdmin''). Mit reinem ''PVEAuditor'' schlagen diese Knöpfe fehl.
  * Nach Änderungen an den Rechten die Integration neu laden: Einstellungen → Geräte & Dienste → Proxmox VE → ⋮ → Neu laden.

==== Wo finde ich das API-Token? ====

Proxmox-Weboberfläche → **Datacenter → Permissions → API Tokens**. Das Secret wird nur beim Anlegen einmal angezeigt. Ist es verloren, ein neues Token anlegen und in Home Assistant unter Proxmox VE → ⋮ → **Neu konfigurieren** eintragen.

===== Geräte und wichtige Entitäten =====

Die Integration legt je Node, VM, Container und Storage ein Gerät an. Einige Sensoren (Backup, Netzwerk, Massenspeicher der VMs) sind standardmäßig **deaktiviert**.

Hinweis: Der RAM-Wert der HA-VM liegt meist bei fast 100 %. Das ist normal, weil Linux freien RAM als Cache nutzt.

===== Dashboard-Ansicht „Proxmox“ =====

Dashboard **Home** → Ansicht **Proxmox** (Pfad ''/dashboard-test/proxmox''). Kompakter Aufbau in zwei Spalten:

* **Server pve** (Glance-Karte): Status, Laufzeit, CPU, RAM, Belegung und freier Platz von ''local'' und ''local-lvm''
  * **Verlauf**: CPU und RAM der letzten 24 Stunden
  * **VMs & Container**: Status, CPU und RAM von Home Assistant, DokuWiki und haos14.2
  * **Steuerung**: HA-Snapshot, DokuWiki neu starten, haos14.2 starten, Proxmox neu starten – jeder Knopf fragt vor dem Auslösen nach

===== Benachrichtigungen =====

Automation **„Proxmox: Warnungen an Norbert melden“** (''automation.proxmox_warnungen_an_norbert_melden''), aufgebaut wie die NAS-Warnung. Meldung **nur an Norbert** per Telegram und als kritische iPhone-Push (kommt auch bei Lautlos/Fokus durch).

^ Auslöser ^ Dauer ^
| Node ''pve'' offline | 5 min |
| Proxmox-Server nicht im Netz (''device_tracker.proxmox'') | 10 min |
| DokuWiki-Container gestoppt | 5 min |
| CPU oder RAM über 90 % | 10 min |
| Speicher ''local'' oder ''local-lvm'' über 90 % belegt | 10 min |

Nicht überwacht: die HA-VM selbst (bei deren Ausfall kann HA nichts senden) und ''haos14.2'' (bewusst aus). Code siehe [[ha:raderbroich:logik:automationen_ueberwachung|Automationen – Überwachung]].

===== Offene Punkte =====

* Speicher ''local'' ist zu 87 % voll (ca. 7 GiB frei). Dort liegen die Backups. Alte Backups löschen oder Backup-Ziel auf ''local-lvm''/NAS verlegen, sonst schlagen Backups fehl.
  * Backup-Sensoren (''sensor.tools_pve_letztes_backup'', ''binary_sensor.tools_pve_backup_status'' …) sind deaktiviert. Bei Bedarf aktivieren und in die Warn-Automation aufnehmen.

Zusammenfassung