Voraussetzungen
Was Sie für die Installation von VexCore HV brauchen.
VexCore HV läuft direkt auf einem Proxmox-VE-Host – auf dem Host, den es verwaltet. Eine separate VM oder ein eigener Server ist nicht nötig. Weitere Proxmox-Hosts und -Cluster binden Sie später über die Oberfläche an.
Checkliste
| Voraussetzung | Details |
|---|---|
| Proxmox VE | Ein Proxmox-VE-Host (Debian-basiert). Das Installationsprogramm bricht ab, wenn es keinen Proxmox-Host erkennt. |
| Root-Zugriff | Die Installation läuft als root in einer Shell auf dem Host (SSH oder Shell in der Proxmox-Oberfläche). |
| Internetzugang | Der Host lädt während der Installation Node.js und Programmpakete aus dem Internet. |
| Node.js 22 oder neuer | Fehlt Node.js oder ist es älter, installiert das Installationsprogramm Node.js 22 automatisch. |
| Freier Port | Bevorzugt 443. Ist 443 belegt, nimmt VexCore HV Port 3000. Siehe Ports. |
| Arbeitsspeicher | Während der Installation wird die Anwendung gebaut; das braucht kurzzeitig spürbar Speicher. Auf sehr knapp ausgestatteten Hosts siehe Build bricht ab. |
Ausgehende Verbindung zum Lizenzserver
Für kostenpflichtige Pläne und die Testphase muss der Host ausgehende HTTPS-Verbindungen (Port 443) zum Colvex-Lizenzserver aufbauen können. Darüber laufen die Lizenzprüfung, die Testphase, der Kauf im Dashboard, der Plan-Katalog und der KI-Assistent.
- Ohne diese Verbindung läuft VexCore HV im kostenlosen Community-Plan.
- Eine kostenpflichtige Lizenz wird nur geprüft – und bleibt nur aktiv –, solange der Host den Lizenzserver erreicht.
- Beschränkt Ihre Firewall ausgehende Verbindungen, geben Sie
api.colvex.de(HTTPS, Port 443) frei. - Installationen, die vor Version 1.0.0 eingerichtet wurden, verwenden unter Umständen noch
colvex-services.vercel.app. Diese Adresse funktioniert weiterhin. Geben Sie im Zweifel beide frei.
npm
Je nach Proxmox-/Debian-Version ist npm nicht im Paket nodejs enthalten. Bricht die Installation mit npm: command not found ab, installieren Sie es nach und starten die Installation erneut:
apt-get install -y npmNächster Schritt
Weiter mit der Installation.