• Deutsch

      • NocoBase-App installieren

      Wenn Sie noch keine NocoBase-Anwendung haben, ist der schnellste Weg: zuerst @nocobase/cli installieren und dann einmal nb init --ui ausführen. In den meisten Fällen reichen die Standardoptionen im Assistenten aus.

      Voraussetzungen

      • Node.js >= 22
      • Yarn 1.x
      • Wenn Sie mit Docker installieren möchten, stellen Sie sicher, dass Docker bereits läuft

      Schritt 1: CLI installieren

      Installieren Sie die NocoBase CLI zunächst global:

      npm install -g @nocobase/cli
nb --version

      Wenn Sie häufig mehrere Terminals gleichzeitig verwenden oder parallel mit AI Agents arbeiten möchten, empfehlen wir zusätzlich einmal nb session setup. So pflegt jede Sitzung ihr eigenes current env, und sie beeinflussen sich weniger leicht gegenseitig.

      Schritt 2: Anwendung initialisieren

      Als Standard empfehlen wir, den visuellen Assistenten direkt zu öffnen:

      nb init --ui

      2026-06-11-20-14-32

      Je nach Setup-Pfad sehen Sie leicht unterschiedliche Schritte. Wenn Sie dem Standardpfad Install a new app folgen, sehen Sie in der Regel diese sechs Schritte:

      1. Getting started - die --env Kennung festlegen und Install a new app auswählen
      2. App environment - Basisdaten der App, Speicherort und Laufzeit-Port festlegen
      3. App source and version - auswählen, wie Sie die App beziehen und welche Quelle und Version Sie verwenden möchten
      4. Configure the database - die integrierte Datenbank oder eine benutzerdefinierte Datenbank wählen
      5. Create an admin account - das erste Administratorkonto einrichten
      6. Connection & authentication - die Zugriffs-URL der App eingeben und eine Authentifizierungsmethode wählen

      Wenn Sie lieber rein im Terminal arbeiten, können Sie auch direkt Folgendes ausführen:

      nb init

      Wenn Sie in Skripten oder in CI initialisieren, nutzen Sie den nicht-interaktiven Modus:

      nb init --yes --env app1
      Installation auf einem Remote-Server

      Wenn Sie nb init --ui auf einem Server ausführen, empfehlen wir, den Standard-Host zuerst auf die aktuelle Server-IP zu setzen. So können Sie den Assistenten im lokalen Browser öffnen.

      nb config set default-ui-host <server-ip>
nb config set default-api-host <server-ip>

      Schritt 3: Prüfen, ob die Anwendung bereit ist

      Nach der Installation sollten Sie in der Regel zuerst diese drei Punkte prüfen:

      • Ob die env erfolgreich gespeichert wurde
      • Ob die Anwendung normal gestartet ist
      • Ob Sie sich mit dem Administratorkonto anmelden können

      Häufig verwendete Befehle:

      nb env list
nb env info
nb app logs

      Bei einer lokalen Standardinstallation können Sie im Browser normalerweise direkt http://localhost:13000 öffnen. Melden Sie sich an und starten Sie dann eine neue AI-Agent-Sitzung oder starten Sie die aktuelle Sitzung neu. Danach kann die AI mit dieser NocoBase-Anwendung arbeiten.

      Die CLI-Konfiguration wird standardmäßig unter ~/.nocobase/ gespeichert. AI Agents können daher in der Regel aus jedem Arbeitsverzeichnis darauf zugreifen.

      Wenn diese Anwendung später produktiv für echte Benutzer bereitgestellt werden soll, empfehlen wir langfristig nicht die direkte Nutzung über IP + port. Der nächste Schritt ist normalerweise ein Reverse Proxy mit HTTPS.