Pulse für Proxmox
Pulse for Proxmox ist ein leichtgewichtiges, echtzeitfähiges Dashboard zur Überwachung von Proxmox-Umgebungen. Es liefert Live-Metriken zu CPU, Arbeitsspeicher, Netzwerk und Festplatten, sowohl für einzelne Hosts als auch für virtuelle Maschinen und Container – alles übersichtlich in einer webbasierten Oberfläche. Dank WebSockets sind die Informationen stets aktuell, und das Dashboard ist auch mobil nutzbar.
Homepage vom Projekt: https://github.com/rcourtman/Pulse
Was macht Pulse besonders?
-
Echtzeit-Dashboard ohne Verzögerung
-
Multi-Node-Überwachung zentral gebündelt
-
Ressourcenschonend – läuft schon mit minimalem RAM
-
Open Source und kostenlos
-
Einfache Installation via Docker, Docker-Compose oder Script
Schritt-für-Schritt-Anleitung zur Installation
1. Voraussetzungen
-
Eine laufende Proxmox-VE-Installation mit API-Zugriff
-
Docker (mind. 20.10.0+) – oder alternativ Zugriff auf die Shell, Github-Script oder Docker-Compose
-
Ein API-Token mit PVEAuditor-Rechten (oder höher, wenn zusätzliche Features wie VM-Disk-Monitoring genutzt werden sollen)
2. API-Token erstellen
-
Proxmox-Webinterface öffnen → Datacenter → Permissions → Users
→ Benutzer (z. B.pulse-monitor) anlegen -
Dann zu Datacenter → Permissions → API Tokens → neuen Token erstellen (z. B.
pulse) -
Privilegtrennung aktivieren, Token sichern (wird nur einmal angezeigt)
-
Rechte zuweisen: PVEAuditor-Rolle für den Token auf dem Pfad
/
3. Installation via Docker-Run
Eine der schnellsten Methoden:
Anschließend im Browser die Adresse http://localhost:7655 öffnen und Pulse verwenden.
4. Alternativ: Docker-Compose Beispiel
Bei mehreren Knoten oder komplexerer Umgebung:
5. Installation per Community-Script (manuell ohne Docker)
Wenn du lieber direkt auf dem Host installieren willst:
Dieses Script erstellt einen eigenen Nutzer, zieht das Repository, installiert Abhängigkeiten, richtet systemd ein und legt ein .env-File an – inklusive der Platzhalter für PROXMOX_HOST, TOKEN_ID, SECRET etc.
6. Konfiguration & erster Start
-
Nach der Installation erreichst du das Dashboard unter
http://<host>:7655 -
Setze im UI ein Passwort über das Quick Security Setup
-
Für Features wie VM-Disk-Monitoring: QEMU-Guest-Agent in den VMs aktivieren und sicherstellen, dass dein Token die nötigen Rechte hat
7. Häufige Probleme & Lösungen
| Problem | Mögliche Lösung |
|---|---|
| Login-Probleme nach Absicherung | Prüfen, ob der bcrypt-Hash exakt 60 Zeichen hat und korrekt escaped ist |
Keine .env-Datei im /data-Verzeichnis (Docker) |
Bei Verwendung von ENV-Variablen wird keine Datei erzeugt – nur bei Quick Setup oder Passwortänderung |
| Verbindungsprobleme zum Proxmox-API | API-Erreichbarkeit prüfen, Tokenrechte kontrollieren, ggf. Firewallports öffnen |
| Hohe CPU-/RAM-Auslastung | Poll-Intervall in den Einstellungen reduzieren, ungenutzte Funktionen abschalten |
| Fehler mit Proxmox 9 | Pulse in aktueller Version verwenden und Setup ggf. neu starten |
Fazit
Pulse for Proxmox ist eine ideale Ergänzung zur nativen Proxmox-Oberfläche – besonders für Multi-Node-Installationen, Homelab-Enthusiasten und Admins, die eine schlanke, zentrale Echtzeit-Übersicht wünschen. Die Installation ist flexibel: Docker-basiert für schnelle Deployments, Script-basiert für manuelle Kontrolle. Mit wenigen Schritten lässt sich das Dashboard aufsetzen, absichern und erweitern.
Pro-Tipp: API-Token mit PVEAuditor und Gastagent in den VMs aktivieren: So erhältst du wirklich vollständige Metriken – auch innerhalb der VMs.
Also: Richte Pulse ein und genieße eine klare Übersicht über deinen Proxmox-Stack!
