• Français

      • Installer l'application NocoBase

      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

      Nous vous recommandons de l'installer avec l'assistant d'UI :

      nb init --ui
      1. Getting started - définir l'identifiant --env et choisir Install a new app

      2026-06-11-20-14-32

      1. App environment - définir les informations de base de l'application, l'emplacement de stockage et le port d'exécution

      2026-06-14-10-03-06

      1. App source and version - choisir comment récupérer l'application, ainsi que la source et la version à utiliser

      2026-06-14-09-51-33

      1. Configure the database - choisir la base de données intégrée ou une base de données personnalisée

      2026-06-14-09-52-05

      1. Create an admin account - configurer le premier compte administrateur

      2026-06-14-09-52-56

      1. Connection & authentication - saisir l'URL d'accès de l'application et choisir une méthode d'authentification

      2026-06-14-10-00-35

      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.

      Étapes suivantes

      Liens connexes