Setup-Wizard

Beim ersten Start öffnet Cuby automatisch den Browser mit dem Setup-Wizard unter http://localhost:3847. Der Wizard führt durch drei Schritte, um die Cuby-Umgebung betriebsbereit zu machen.

Schritt 1: API Key

Der API Key authentifiziert Cuby gegenüber dem ProcessCube® Marketplace und wird für den Zugriff auf die npm-Registry benötigt. Es gibt zwei Optionen:

Trial-Lizenz erstellen

Für den schnellen Einstieg kann eine kostenlose 30-Tage-Testlizenz erstellt werden. Cuby generiert automatisch einen UUID v4 API Key und registriert ihn beim Marketplace.

Bestehenden API Key eingeben

Ein vorhandener API Key im UUID v4 Format (xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx). API Keys sind auf den ProcessCube®-Rechnungen unter processcube.io/invoices  zu finden.

Der API Key wird gegen den Marketplace validiert und sicher im Secret Store gespeichert — nicht in der Konfigurationsdatei.

Schritt 2: Systemeinrichtung

Cuby installiert eine verwaltete Node.js-Umgebung (v22) via fnm .

• Die Installation erfolgt unabhängig von einer eventuell vorhandenen Node.js-Installation
• Eine bestehende Node.js-Umgebung wird nicht beeinflusst
• Der Fortschritt wird in Echtzeit angezeigt
• Bei Fehlern kann der Schritt wiederholt werden

Das verwaltete Node.js wird für Plugin-Worker-Prozesse benötigt, die Lifecycle-Methoden der installierten Produkte ausführen.

Schritt 3: Autostart

Optional kann Cuby so konfiguriert werden, dass es beim Systemstart automatisch startet:

Die Autostart-Einstellung kann jederzeit nachträglich über die API oder das Dashboard geändert werden.

Nach dem Wizard

Nach Abschluss des Wizards wird setupComplete: true in der Konfiguration gespeichert.

Bei weiteren Starts:

• Kein Browser wird automatisch geöffnet
• Installierte Produkte werden automatisch gestartet
• Das Management-Interface ist unter http://localhost:3847 erreichbar

Der nächste Schritt ist das Dashboard, über das Produkte aus dem Marketplace installiert werden können.