VexCore HVDocs

Updates

VexCore HV auf eine neue Version aktualisieren, ohne Einstellungen und Daten zu verlieren.

Ein Update führen Sie mit dem Installationsprogramm durch. Es erkennt die bestehende Installation, übernimmt Ihre Einstellungen und baut die neue Version.

Platzhalter – Update-Befehl folgt

Den Installationsbefehl erhalten Sie mit Ihrer Lizenz. Wie die neue Version auf den Host gelangt, wird hier ergänzt, sobald der öffentliche Installationsweg feststeht.

Vor dem Update

Sichern Sie das Installationsverzeichnis, mindestens den Ordner data/ und die Datei .env.local:

cd /root/proxmox-dashboard
tar czf /root/vexcore-backup-$(date +%F).tar.gz data .env.local

Update durchführen

Führen Sie das Installationsprogramm erneut als root aus und beantworten Sie die Fragen so:

FrageAntwort
Target directoryIhr Installationsverzeichnis (Vorschlag mit Enter übernehmen).
Directory already contains a VexCore HV installationDie Option zum Aktualisieren wählen.
Overwrite it with freshly generated values …?N (Standard) – .env.local behalten.

.env.local nicht überschreiben

Wer hier mit y antwortet, erzeugt neue Schlüssel: Alle Benutzer werden abgemeldet und gespeicherte Zugangsdaten für den Remote-Zugriff sind nicht mehr lesbar. Behalten Sie die bestehende Datei.

Was beim Update passiert:

  • Eine behaltene .env.local wird nur um fehlende Werte ergänzt; vorhandene Werte bleiben unverändert.
  • Da die Ersteinrichtung schon abgeschlossen ist, bleiben Administrator-Konto, Passwort und Proxmox-Verbindung unangetastet. Es wird kein neues API-Token angelegt.
  • Die Anwendung wird neu gebaut und der Dienst neu gestartet. Port-Einstellungen in der systemd-Unit bleiben erhalten.

Nach dem Update

  • Bestehende Anmeldungen bleiben in der Regel erhalten; schlimmstenfalls melden Sie sich einmal neu an.
  • Bereits geöffnete Browser-Tabs zeigen den Hinweis A new version of VexCore is available. Klicken Sie auf Reload, um die neue Version zu laden.
  • Prüfen Sie den Dienst:
systemctl status vexcore-hv
journalctl -u vexcore-hv -n 20 --no-pager | grep Ready

Ältere Installationen

Installationen, die noch auf Port 3000 laufen, behalten ihren Port auch nach dem Update. Den Wechsel auf Port 443 beschreibt Ports → Ältere Installationen.

Auf dieser Seite