Installation
VexCore HV mit dem Installationsprogramm auf einem Proxmox-VE-Host installieren.
Das Installationsprogramm richtet VexCore HV vollständig ein: Es installiert Node.js, baut die Anwendung, legt einen systemd-Dienst an und schließt die Ersteinrichtung ab. Danach können Sie sich sofort anmelden.
Installationsbefehl
Platzhalter – Installationsbefehl folgt
Den Installationsbefehl erhalten Sie mit Ihrer Lizenz.
Führen Sie den Befehl als root in einer Shell auf dem Proxmox-Host aus. Das Programm fragt an zwei Stellen nach und arbeitet sonst selbstständig.
Ablauf
Prüfung der Voraussetzungen
Das Programm prüft, ob es als root auf einem Proxmox-VE-Host läuft, und installiert bei Bedarf Node.js 22.
Installationsverzeichnis
Es fragt nach dem Zielverzeichnis. Mit Enter übernehmen Sie den Vorschlag /root/proxmox-dashboard.
Existiert das Verzeichnis bereits mit einer VexCore-HV-Installation, können Sie es unverändert lassen, aktualisieren oder abbrechen – siehe Updates.
Konfiguration und Schlüssel
Das Programm fragt nach der Adresse, unter der VexCore HV erreichbar sein soll, und schlägt https://<IP-Adresse des Hosts> vor. Übernehmen Sie den Vorschlag mit Enter.
Anschließend erzeugt es die Datei .env.local im Installationsverzeichnis mit zufälligen Schlüsseln (u. a. für die Anmeldesitzungen und für gespeicherte Zugangsdaten). Die Datei ist nur für root lesbar.
Sichern Sie .env.local zusammen mit dem Ordner data/
Geht .env.local verloren oder wird sie neu erzeugt, sind gespeicherte Zugangsdaten für den Remote-Zugriff nicht mehr lesbar und alle Benutzer müssen sich neu anmelden. Nehmen Sie .env.local und data/ gemeinsam in Ihre Sicherung auf.
Build
Das Programm installiert die Pakete und baut die Anwendung. Das dauert je nach Host einige Minuten.
Dienst einrichten
Es legt den systemd-Dienst vexcore-hv an, aktiviert ihn für den Systemstart und startet ihn. VexCore HV lauscht auf Port 443, falls dieser frei ist, sonst auf 3000 (Ports).
Ersteinrichtung
Zum Schluss schließt das Programm die Ersteinrichtung automatisch ab:
- Es legt in Proxmox ein API-Token
root@pam!vexcore-hv-<zufällig>mit der Rolle Administrator an. VexCore HV spricht Proxmox ausschließlich über dieses Token an; ein Passwort wird nicht gespeichert. - Es legt den Benutzer
adminmit einem zufällig erzeugten Passwort an. Jede Installation bekommt ein eigenes; das Programm zeigt es nur einmal am Ende an. - VexCore HV startet im Community-Plan. Einen Lizenzschlüssel aktivieren Sie später auf der Seite License.
Ausgabe am Ende
Am Ende zeigt das Programm die Adresse, die Zugangsdaten und den Fingerabdruck des Zertifikats, zum Beispiel:
✓ VexCore HV is running at: https://192.0.2.10
HTTPS uses the Proxmox node certificate (the same one as port 8006), so the
browser warns until you accept it or import the Proxmox root CA
(Settings -> HTTPS -> 'Proxmox root CA'). Check the fingerprint it shows:
SHA-256 3A:7F:…:C2
Login: Username: admin Password: <zufällig>
! Change this password after your first login (Settings -> Change password).Notieren Sie sich das Passwort und den SHA-256-Fingerabdruck. Das Passwort wird nirgends sonst angezeigt. Den Fingerabdruck vergleichen Sie beim ersten Login mit dem, was Ihr Browser anzeigt.
install-finished.pngPort selbst wählen
Soll VexCore HV auf einem anderen Port als 443 laufen, setzen Sie vor dem Installationsbefehl die Variable VEXCORE_PORT:
VEXCORE_PORT=8443 <Installationsbefehl>Ist der Port durch ein anderes Programm belegt, bricht die Installation mit einem Hinweis ab. Mehr dazu unter Ports.
Wenn etwas schiefgeht
Build bricht ab
Auf Hosts mit wenig Arbeitsspeicher kann der Build mit Next.js build worker exited with code: null and signal: SIGSEGV abbrechen. Bauen Sie dann im Installationsverzeichnis mit mehr Speicher für Node.js und starten Sie die Installation anschließend erneut:
cd /root/proxmox-dashboard
NODE_OPTIONS="--max-old-space-size=1536" npm run buildDienst startet nicht
Das Programm zeigt in diesem Fall die letzten Protokollzeilen. Häufigste Ursache ist ein belegter Port (port 443 is in use by another program). Weitere Prüfungen:
systemctl status vexcore-hv
journalctl -u vexcore-hv -n 50 --no-pagerNach der Behebung starten Sie den Dienst mit systemctl restart vexcore-hv neu.
Ersteinrichtung wurde nicht abgeschlossen
Konnte das Programm die Ersteinrichtung nicht automatisch abschließen, meldet es das am Ende („Automated setup did not complete“). Öffnen Sie dann https://<Host>/setup im Browser und führen Sie den Setup-Assistenten aus – siehe Erster Login.
Abgebrochene Installation und API-Token
Haben Sie nach einer abgebrochenen Installation das Verzeichnis gelöscht, bleibt ein bereits angelegtes API-Token in Proxmox bestehen. Entfernen Sie es unter Datacenter → Permissions → API Tokens, wenn es nicht verwendet wird.