• Deutsch

      • NocoBase-App installieren

      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

      Wir empfehlen die Installation über den UI-Assistenten:

      nb init --ui
      1. Getting started - die --env Kennung festlegen und Install a new app auswählen

      2026-06-11-20-14-32

      1. App environment - Basisdaten der App, Speicherort und Laufzeit-Port festlegen

      2026-06-14-10-03-06

      1. App source and version - auswählen, wie Sie die App beziehen und welche Quelle und Version Sie verwenden möchten

      2026-06-14-09-51-33

      1. Configure the database - die integrierte Datenbank oder eine benutzerdefinierte Datenbank wählen

      2026-06-14-09-52-05

      1. Create an admin account - das erste Administratorkonto einrichten

      2026-06-14-09-52-56

      1. Connection & authentication - die Zugriffs-URL der App eingeben und eine Authentifizierungsmethode wählen

      2026-06-14-10-00-35

      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.

      Nächste Schritte