• Français

      • Installer l'application NocoBase

      Si vous n'avez pas encore d'application NocoBase, le plus rapide est d'installer d'abord @nocobase/cli, puis d'exécuter une fois nb init --ui. Dans la plupart des cas, les options par défaut de l'assistant suffisent.

      Prérequis

      • Node.js >= 22
      • Yarn 1.x
      • Si vous comptez installer avec Docker, assurez-vous d'abord que Docker est déjà lancé

      Étape 1 : installer la CLI

      Installez d'abord NocoBase CLI globalement :

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

      Si vous travaillez souvent avec plusieurs terminaux en parallèle, ou si vous voulez avancer en même temps qu'un AI Agent, nous vous recommandons aussi d'exécuter nb session setup une fois. Ainsi, chaque session conserve son propre current env, et elles se perturbent moins facilement.

      Étape 2 : initialiser l'application

      Par défaut, nous vous recommandons d'ouvrir directement l'assistant visuel :

      nb init --ui

      2026-06-11-20-14-32

      Selon le chemin de setup choisi, les étapes affichées peuvent varier un peu. Si vous suivez le chemin par défaut Install a new app, vous verrez généralement ces six étapes :

      1. Getting started - définir l'identifiant --env et choisir Install a new app
      2. App environment - définir les informations de base de l'application, l'emplacement de stockage et le port d'exécution
      3. App source and version - choisir comment récupérer l'application, ainsi que la source et la version à utiliser
      4. Configure the database - choisir la base de données intégrée ou une base de données personnalisée
      5. Create an admin account - configurer le premier compte administrateur
      6. Connection & authentication - saisir l'URL d'accès de l'application et choisir une méthode d'authentification

      Si vous préférez rester dans le terminal, vous pouvez aussi exécuter directement :

      nb init

      Si vous initialisez dans des scripts ou dans un pipeline CI, utilisez le mode non interactif :

      nb init --yes --env app1
      Installation sur un serveur distant

      Si vous exécutez nb init --ui sur un serveur, nous vous recommandons de remplacer d'abord le host par défaut par l'IP actuelle de ce serveur. Vous pourrez ainsi ouvrir l'assistant depuis votre navigateur local.

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

      Étape 3 : vérifier que l'application est prête

      Après l'installation, il vaut généralement mieux vérifier d'abord ces trois points :

      • L'env a bien été enregistré
      • L'application a bien démarré
      • Vous pouvez vous connecter avec le compte administrateur

      Les commandes les plus courantes sont :

      nb env list
nb env info
nb app logs

      Pour une installation locale avec la configuration par défaut, vous pouvez généralement ouvrir directement http://localhost:13000 dans le navigateur. Une fois connecté, ouvrez une nouvelle session AI Agent ou redémarrez la session actuelle, et l'IA pourra commencer à travailler avec cette application NocoBase.

      La configuration de la CLI est enregistrée par défaut dans ~/.nocobase/, de sorte que les AI Agents peuvent généralement y accéder depuis n'importe quel répertoire de travail.

      Si cette application doit ensuite être exposée à de vrais utilisateurs, nous ne recommandons pas d'utiliser durablement IP + port tel quel. L'étape suivante consiste généralement à mettre en place un reverse proxy et à activer HTTPS.

      Liens connexes