Skip to Content
CubySetup-Wizard

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:

Schritt 1: API Key

Es gibt zwei Optionen:

  • Trial-Lizenz — Erstellt eine kostenlose 30-Tage-Testlizenz. Cuby generiert automatisch einen UUID v4 API Key und registriert ihn beim Marketplace.
  • API Key eingeben — Vorhandener API Key im UUID v4 Format (xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx). Verfügbar unter processcube.io/invoices .

Der API Key wird gegen den Marketplace validiert und für die Authentifizierung bei der npm-Registry verwendet.

Schritt 2: Systemeinrichtung

Cuby installiert automatisch eine verwaltete Node.js-Umgebung (v22) via fnm . Dies geschieht unabhängig von einer eventuell vorhandenen Node.js-Installation und beeinflusst diese nicht.

Der Fortschritt wird in Echtzeit angezeigt. Bei Fehlern kann der Schritt wiederholt werden.

Schritt 3: Autostart

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

  • macOS: LaunchAgent (~/Library/LaunchAgents/)
  • Windows: Verknüpfung im Startup-Ordner
  • Linux: Desktop-Entry (~/.config/autostart/)

Nach dem Setup

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

  • Der Browser wird nicht automatisch geöffnet
  • Installierte Produkte werden automatisch gestartet
  • Das Dashboard ist unter http://localhost:3847 erreichbar

Setup erneut durchführen

Um den Setup-Wizard erneut zu starten, setzen Sie setupComplete in der Konfigurationsdatei auf false:

{
  "setupComplete": false
}
InstallationDashboard