Résumé rapide : L'exécution de n8n localement nécessite npm (Node.js 20.19-24.x) ou Docker. La méthode la plus rapide utilise npx n8n pour des tests immédiats sans installation, tandis que Docker offre une meilleure isolation et une meilleure préparation à la production. Les deux méthodes vous donnent un accès complet aux capacités d'automatisation des workflows de n8n sans frais récurrents de cloud.
La configuration de n8n sur une machine locale élimine les frais d'abonnement récurrents tout en offrant un contrôle complet sur l'automatisation des workflows. Selon la documentation officielle de n8n, la plateforme nécessite une version de Node.js comprise entre 20.19 et 24.x pour les installations npm, ou Docker pour les déploiements conteneurisés.
La décision entre l'hébergement local et les services cloud a un impact sur le budget et la flexibilité. Selon les discussions de la communauté, les installations locales gèrent des workflows illimités, tandis que les plans cloud incluent une tarification basée sur l'exécution (à partir de 24 $/mois pour 2 500 exécutions selon certains rapports d'utilisateurs).
Prérequis pour l'installation locale
Avant d'installer n8n localement, le système a besoin de logiciels spécifiques en fonction de la méthode choisie.
La version de Node.js requise pour une installation npm dépend entièrement des exigences spécifiques de la version de n8n que vous déployez, car npm lui-même est compatible avec toutes les versions LTS actuellement prises en charge de Node.js. La documentation officielle spécifie cette plage exacte de versions pour la compatibilité. Vérifiez la version actuelle en exécutant node --version dans le terminal.
Les installations Docker nécessitent Docker Engine ou Docker Desktop. L'équipe n8n recommande Docker pour la plupart des besoins d'auto-hébergement, car il offre une isolation nette et évite les incompatibilités de système d'exploitation.
Configuration système
Les instances n8n locales s'exécutent sur les systèmes Windows, macOS et Linux. Aucune spécification minimale de RAM n'apparaît dans la documentation officielle, mais la complexité du workflow détermine les besoins réels en ressources.
L'installation consomme initialement un espace disque minimal. Les besoins en stockage augmentent en fonction des données du workflow, de l'historique des exécutions et des packages de nœuds personnalisés.
Méthode 1 : Exécuter n8n avec npm
L'installation npm offre le chemin le plus rapide pour exécuter n8n localement. Cette méthode fonctionne directement sur le système hôte sans conteneurisation.
Démarrage rapide avec npx
L'approche la plus simple utilise npx sans installation permanente. Ouvrez un terminal et exécutez :
| npx n8n |
Cette commande télécharge tout le nécessaire et démarre n8n automatiquement. L'interface devient accessible à localhost:5678 en quelques secondes.
La méthode npx fonctionne parfaitement pour les tests et l'évaluation. Elle ne nécessite pas de packages npm globaux ni de modifications permanentes du système.
Installation globale npm
Pour une installation permanente, le package npm global offre un accès cohérent :
| npm install n8n -g |
Une fois l'installation terminée, démarrez n8n à tout moment en exécutant :
| n8n |
La version stable majeure actuelle de n8n est la 2.x (par exemple, 2.10.4). Les versions bêta peuvent contenir des fonctionnalités instables et doivent être évitées pour les workflows de production.
Configuration et stockage des données
Les installations npm stockent les données du workflow dans le répertoire ~/.n8n par défaut. Cet emplacement contient les identifiants, les définitions de workflow et l'historique des exécutions.
Les variables d'environnement contrôlent le comportement de n8n. Définissez la variable N8N_PORT pour modifier le port par défaut 5678. D'autres variables configurent les connexions de base de données, les URL de webhook et les paramètres d'authentification.
Méthode 2 : Exécuter n8n avec Docker
L'installation Docker représente l'approche recommandée pour l'hébergement local de n8n. La documentation officielle met l'accent sur Docker pour les besoins d'auto-hébergement en production.
Commande de base Docker run
Démarrez n8n avec une seule commande Docker :
| docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Cette commande crée un conteneur nommé n8n, mappe le port 5678 à l'hôte et persiste les données dans le répertoire ~/.n8n.
Le conteneur s'exécute interactivement avec le drapeau -it. Supprimez --rm pour conserver le conteneur après l'avoir arrêté.
Docker Compose pour la configuration de production
Les configurations Docker Compose offrent un meilleur contrôle pour les environnements de production. Le dépôt n8n-hosting sur GitHub contient des fichiers Docker Compose prêts à l'emploi pour diverses architectures.
Une configuration docker-compose.yml de base ressemble à ceci :
| version: '3.8' services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=password volumes: - ~/.n8n:/home/node/.n8n |
Démarrez la pile avec :
| docker-compose up -d |
Le drapeau -d exécute les conteneurs en mode détaché, permettant l'utilisation du terminal pour d'autres tâches.
Configuration initiale et accès
Après avoir démarré n8n via l'une ou l'autre méthode, naviguez vers localhost:5678 dans un navigateur Web. L'écran de configuration initiale demande une adresse e-mail et un mot de passe pour le compte administrateur.
Ce premier utilisateur devient le propriétaire de l'instance avec des privilèges administratifs complets. Des utilisateurs supplémentaires peuvent être ajoutés ultérieurement via l'interface de gestion des utilisateurs.
Configuration de l'authentification
Pour des raisons de sécurité, activez l'authentification même sur les installations locales. Les configurations Docker Compose acceptent directement les variables d'environnement d'authentification :
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=strongpassword |
Ces variables activent l'authentification HTTP de base, nécessitant des identifiants pour toutes les tentatives d'accès.
Tester les nœuds personnalisés localement
La documentation officielle explique comment tester des nœuds personnalisés pendant le développement. Installez d'abord n8n globalement, puis construisez et liez le package de nœud personnalisé.
Dans le répertoire du nœud personnalisé, exécutez :
| npm run build npm link |
Accédez ensuite au répertoire des nœuds n8n (généralement ~/.n8n/custom/) et liez le package :
| npm link <nom-du-package-nœud> |
Le nœud personnalisé apparaît dans l'interface n8n après le redémarrage de l'instance.
Ressources d'automatisation utiles à utiliser avec n8n
Si vous apprenez à exécuter n8n localement et que vous testez des workflows sur votre machine, vous pourriez également bénéficier d'outils et de modèles externes qui facilitent l'automatisation des tâches courantes. Get AI Perks propose une bibliothèque de modèles de workflow et d'outils assistés par IA que vous pouvez utiliser avec n8n ou pour prototyper des idées d'automatisation avant de les créer vous-même.
Avec Get AI Perks, vous pouvez :
- Commencer à partir de modèles de workflow pré-construits
- Obtenir une assistance IA pour la logique et le contenu de routine
- Explorer des modèles d'automatisation courants avant de les implémenter dans n8n
- Combiner des modèles avec votre configuration n8n locale
Découvrez Get AI Perks pour trouver des outils d'automatisation qui prennent en charge vos workflows n8n.
Dépannage des problèmes courants
Les conflits de ports représentent le problème d'installation le plus fréquent. Si le port 5678 est déjà utilisé, arrêtez le service conflictuel ou modifiez le port de n8n en utilisant la variable d'environnement N8N_PORT.
Incompatibilité de version de Node
L'utilisation de versions de Node.js en dehors de la plage 20.19-24.x entraîne des échecs d'installation. Le dépôt GitHub de n8n documente les problèmes lorsque les développeurs tentent des environnements de développement locaux, soulignant l'importance de la compatibilité des versions de Node.
Vérifiez la compatibilité des versions de Node avant de résoudre d'autres problèmes. Changez les versions de Node en utilisant nvm (Node Version Manager) si nécessaire.
Erreurs de permission de volume Docker
Les problèmes de permission avec le montage de volume ~/.n8n empêchent la persistance des données. Les conteneurs Docker s'exécutent en tant qu'utilisateur node, qui pourrait ne pas avoir les droits d'écriture sur le répertoire hôte.
Créez le répertoire avec les permissions appropriées avant de démarrer le conteneur :
| mkdir ~/.n8n chmod 777 ~/.n8n |
Questions fréquemment posées
n8n peut-il fonctionner sans accès Internet ?
Oui, n8n fonctionne entièrement hors ligne pour les workflows locaux. La connectivité Internet devient nécessaire uniquement lorsque les workflows interagissent avec des API externes ou des services cloud.
Combien coûte l'exécution de n8n localement ?
Les installations locales sont gratuites. L'édition communautaire fournit toutes les fonctionnalités principales sans frais de licence. L'hébergement cloud commence avec des limites d'exécution et des coûts mensuels, mais l'hébergement local supprime entièrement ces restrictions, selon les discussions de la communauté.
Les débutants doivent-ils utiliser npm ou Docker ?
Les débutants qui testent n8n devraient commencer par npx pour un accès immédiat. Docker est plus pertinent pour une utilisation continue car il offre une meilleure isolation et des mises à jour plus faciles.
Où n8n stocke-t-il les données de workflow localement ?
Le répertoire de données par défaut est ~/.n8n dans le dossier personnel de l'utilisateur. Cet emplacement contient les fichiers de base de données SQLite, les identifiants et les journaux d'exécution, sauf configuration contraire.
Plusieurs instances n8n peuvent-elles fonctionner sur une seule machine ?
Oui, mais chaque instance a besoin d'un port unique. Définissez des ports différents en utilisant la variable d'environnement N8N_PORT pour chaque instance. Docker facilite cela grâce au mappage de ports dans des conteneurs séparés.
Comment fonctionnent les mises à jour pour les installations locales ?
Les installations npm se mettent à jour via npm update -g n8n ou npm install -g n8n@latest. Les utilisateurs de Docker extraient la dernière image avec docker pull n8nio/n8n, puis recréent les conteneurs. Sauvegardez toujours le répertoire ~/.n8n avant de mettre à jour.
Considérations de production
La documentation officielle de n8n souligne que l'auto-hébergement nécessite des connaissances techniques. La configuration de serveurs, la gestion des ressources et la sécurisation des applications exigent une expérience en administration système.
Pour les déploiements en production, Docker Compose fournit la base. Ajoutez un proxy inverse comme nginx ou Caddy pour le support HTTPS. Le dépôt n8n-hosting inclut des configurations Caddy prêtes pour le déploiement.
Le choix de la base de données est important pour les charges de travail lourdes. La base de données SQLite par défaut convient à une utilisation modérée, mais PostgreSQL offre de meilleures performances pour l'automatisation à haut volume selon les conseils officiels.
Faire le choix : Local vs Cloud
L'hébergement local de n8n convient aux équipes disposant de capacités techniques et d'exigences de sécurité spécifiques. Les données restent sur une infrastructure contrôlée et les limites d'exécution disparaissent.
Cependant, l'hébergement local nécessite une maintenance, des sauvegardes et une surveillance. L'hébergement cloud transfère ces responsabilités à l'équipe d'infrastructure de n8n. Consultez le site officiel pour connaître les tarifs cloud actuels et les comparaisons de fonctionnalités.
L'exécution de n8n localement offre un contrôle total sur l'infrastructure d'automatisation des workflows. Que ce soit en utilisant npm pour des tests rapides ou Docker pour des déploiements en production, les deux méthodes fournissent la plateforme complète sans coûts récurrents. Commencez avec npx pour une exploration immédiate, puis passez à Docker lorsque les workflows se rapprochent d'une utilisation en production.
