Déploiement local de n8n

Déployez n8n localement sur Linux/macOS, installez le nœud communautaire CometAPI et configurez les identifiants API pour exécuter des workflows automatisés sur votre machine.

Déployez n8n sur votre propre machine et connectez-le à CometAPI via le nœud communautaire pour exécuter localement des workflows IA automatisés.

​

Prérequis

• Linux (Ubuntu/Debian/CentOS, etc.) ou macOS
• 2 Go+ de RAM, 10 Go+ d’espace disque libre
• Accès au shell avec accès au registre npm public
• Node.js 18.x ou 20.x LTS (voir l’étape 1)
• Un compte CometAPI avec une clé API active — obtenez la vôtre ici

1. Obtenez votre clé API CometAPI

   Connectez-vous à la console CometAPI. Cliquez sur Add API Key et copiez votre clé sk-xxxxx.

   

   
2. Installez Node.js via nvm

   n8n 1.x nécessite Node.js 18.x ou 20.x. L’approche recommandée est nvm:

   # Install nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   
   # Reload your shell profile
   source ~/.bashrc   # or ~/.zshrc on macOS
   
   # Install and activate the LTS version
   nvm install --lts
   nvm use --lts
   
   # Verify
   node -v
   npm -v
   

   Si vous voyez n8n: command not found plus tard, redémarrez le terminal ou assurez-vous que le répertoire global bin npm géré par nvm est bien dans votre PATH.

3. Installez et démarrez n8n

   npm install -g n8n
   n8n -v       # verify the installed version
   n8n start    # runs on http://localhost:5678/
   

   Si le port 5678 est déjà utilisé :

   export N8N_PORT=5679
   n8n start
   

   Pour maintenir n8n en cours d’exécution après la fermeture du terminal :

   npm install -g pm2
   pm2 start "n8n" --name n8n
   pm2 save
   pm2 status
   

   

   
4. Créez votre compte propriétaire

   Ouvrez http://localhost:5678/ dans votre navigateur. Lors du premier lancement, l’assistant de configuration vous demande de créer un compte Owner (e-mail + mot de passe). Terminez cette étape puis connectez-vous.

   
5. Installez le nœud communautaire CometAPI

   1. Allez dans Settings (en bas à gauche) → Community nodes
   2. Cliquez sur Install a community node
   3. Saisissez le nom du package : @cometapi-dev/n8n-nodes-cometapi
   4. Cochez la case de reconnaissance des risques puis cliquez sur Install

   Après l’installation, vous pouvez rechercher CometAPI dans le panneau des nœuds.

   

   

   Si la section Community Nodes n’apparaît pas : assurez-vous d’être connecté avec le compte Owner, puis vérifiez dans Settings → Security que l’installation des nœuds communautaires est activée.

6. Créez un workflow et configurez les identifiants

   1. Cliquez sur + New en haut pour créer un workflow.
   2. Cliquez sur + sur le canevas et recherchez CometAPI pour ajouter le nœud.

   

   

   3. Ajoutez un nœud Manual Trigger et connectez-le au nœud CometAPI.
   4. Dans le nœud CometAPI, sous Credential to connect with, choisissez Create new. Collez votre clé sk-xxxxx dans CometAPI Key puis cliquez sur Save. L’URL de base est par défaut https://api.cometapi.com et n’a généralement pas besoin d’être modifiée.

   

   5. Configurez le nœud :

   • Model : saisissez l’ID du modèle actuel que vous souhaitez utiliser
   • Messages : définissez Role sur user, Content sur votre prompt de test (par ex. Hello)
   • Facultatif : ajoutez un message system, définissez Max Tokens, Temperature, etc.

   6. Cliquez sur Execute step pour exécuter le nœud. Le panneau Output affiche la réponse JSON.

   

Résolution des problèmes

• Erreurs node-gyp ou de build natif — installez les outils de compilation : sudo apt install build-essential python3 (Debian/Ubuntu) ou les Xcode Command Line Tools (macOS).
• Erreurs de permissions npm (EACCES) — utilisez nvm pour une installation de Node.js au niveau utilisateur ; aucun sudo n’est nécessaire.
• Conflit de port (localhost:5678 indisponible) — définissez N8N_PORT=5679 (ou un autre port libre) avant d’exécuter n8n start.
• Section Community Nodes absente — connectez-vous avec le compte Owner et vérifiez Settings → Security.
• Échec de npm install sur les réseaux d’entreprise — configurez un proxy : npm config set proxy http://user:pass@host:port
• Le nœud CometAPI renvoie 401/403 — vérifiez votre clé API et que le modèle est accessible avec votre offre CometAPI.
• Réponses vides ou erreurs de limite de token — augmentez Max Tokens ; ajustez Temperature et Top P selon les besoins.
• n8n s’arrête quand le terminal se ferme — utilisez pm2 : pm2 start "n8n" --name n8n && pm2 save.