PatchMon Update-Fehler beheben: Guide für Version 1.4.1 und 1.4.2
Beim Upgrade von PatchMon auf die neuesten Versionen kann es vorkommen, dass das Dashboard nicht lädt oder die Kommunikation zwischen Frontend und Backend gestört ist. Ursache sind oft Formatierungsfehler in den Umgebungsvariablen oder veraltete Build-Dateien.
Hier ist die Schritt-für-Schritt-Anleitung, um deine Instanz wieder flott zu machen.
Schritt 1: Vorbereitung
Stoppe den PatchMon-Dienst, um Datenkorruption während der Bearbeitung zu vermeiden: systemctl stop patchmon-server
Schritt 2: Backend-Konfiguration bereinigen
Prüfe die Datei /opt/patchmon/backend/.env. Entferne jegliche Einrückungen (Spaces/Tabs) am Zeilenanfang. Die Struktur sollte exakt so aussehen:
-
PORT=3001(Interner API-Port) -
SERVER_PROTOCOL=http(oder https) -
SERVER_HOST=DEINE_IP -
SERVER_PORT=3000(Port, unter dem Nginx lauscht)
Schritt 3: Frontend-API-Anbindung fixen
In der Datei /opt/patchmon/frontend/.env muss die VITE_API_URL präzise definiert sein. Wichtig: Keine Leerzeichen und der korrekte API-Port (3001): VITE_API_URL=http://DEINE_IP:3001/api/v1
Schritt 4: Nginx und Rebuild
Stelle sicher, dass deine Nginx-Konf (/etc/nginx/sites-available/patchmon.conf) auf listen 3000; eingestellt ist. Teste sie mit nginx -t und starte den Dienst neu.
Anschließend muss das Frontend neu gebaut werden, um die Änderungen zu übernehmen:
-
Wechsle nach
/opt/patchmon/frontend. -
Lösche alte Altlasten:
rm -rf ./dist ./node_modules -
Installiere Abhängigkeiten:
npm install --include=dev(mit den entsprechenden Flags für Production). -
Baue das Projekt neu:
npm run build
Schritt 5: Neustart und Monitoring
Starte den Dienst und beobachte die Logs in Echtzeit: systemctl start patchmon-server && journalctl -f -u patchmon-server
Fazit
Die meisten Update-Probleme bei PatchMon 1.4.x lassen sich durch eine saubere Trennung von API- und Web-Ports sowie einen frischen Build lösen. Eine präzise .env-Datei ist hier das A und O.
Quelle: https://github.com/community-scripts/ProxmoxVE/discussions/12092