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:

1. Wechsle nach /opt/patchmon/frontend.

2. Lösche alte Altlasten: rm -rf ./dist ./node_modules

3. Installiere Abhängigkeiten: npm install --include=dev (mit den entsprechenden Flags für Production).

4. 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

Der Beitrag PatchMon: Update error by update from 1.4.0 -> 1.4.1 oder 1.4.1 -> 1.4.2 erschien zuerst auf Ivan Ivanov.