Domotique
Fiche mise à jour le
n8n
Reliez vos services par des workflows visuels et des agents IA, avec du code si besoin.
- Version stable
- 2.48.6sortie le
- Image Docker
- n8nio/n8n
- Port
- 5678
- Données
- /home/node/.n8n
- Licence
- Sustainable Use Licensefair-code
- Étoiles GitHub
- 211 160
- Téléchargements
- 288 millionsDocker Hub
Fichiers de configuration
Ce fichier lit 7 variables dans un fichier .env placé à côté : N8N_VERSION, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB, POSTGRES_NON_ROOT_USER, POSTGRES_NON_ROOT_PASSWORD, RUNNERS_AUTH_TOKEN. Voir le .env d’exemple officiel
services:
n8n:
image: docker.n8n.io/n8nio/n8n:${N8N_VERSION}
restart: always
environment:
- N8N_DEPLOYMENT_ARTIFACT=docker-compose
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
- DB_POSTGRESDB_USER=${POSTGRES_NON_ROOT_USER}
- DB_POSTGRESDB_PASSWORD=${POSTGRES_NON_ROOT_PASSWORD}
- N8N_RUNNERS_MODE=external
- N8N_RUNNERS_AUTH_TOKEN=${RUNNERS_AUTH_TOKEN}
- N8N_RUNNERS_BROKER_LISTEN_ADDRESS=0.0.0.0
ports:
- 5678:5678
links:
- postgres
volumes:
- n8n_storage:/home/node/.n8n
depends_on:
postgres:
condition: service_healthy
postgres:
image: postgres:18
restart: always
environment:
- POSTGRES_USER
- POSTGRES_PASSWORD
- POSTGRES_DB
- POSTGRES_NON_ROOT_USER
- POSTGRES_NON_ROOT_PASSWORD
# postgres:18 moved its default data dir. Pinning it keeps the volume
# mount stable across major versions.
- PGDATA=/var/lib/postgresql/data
volumes:
- db_storage:/var/lib/postgresql/data
- ./init-data.sh:/docker-entrypoint-initdb.d/init-data.sh
healthcheck:
test: ['CMD-SHELL', 'pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}']
interval: 5s
timeout: 5s
retries: 10
n8n-runner:
image: n8nio/runners:${N8N_VERSION}
restart: always
environment:
- N8N_RUNNERS_AUTH_TOKEN=${RUNNERS_AUTH_TOKEN}
- N8N_RUNNERS_TASK_BROKER_URI=http://n8n:5679
depends_on:
- n8n
volumes:
db_storage:
n8n_storage:n8n avec PostgreSQL et un exécuteur de tâches séparé. Ajoutez aussi init-data.sh, puis lancez docker compose up -d.
# documentation: https://n8n.io
# slogan: n8n is an extendable workflow automation tool.
# category: automation
# tags: n8n,workflow,automation,open,source,low,code
# logo: svgs/n8n.png
# port: 5678
services:
n8n:
image: n8nio/n8n:2.47.7
environment:
- SERVICE_URL_N8N_5678
- N8N_EDITOR_BASE_URL=${SERVICE_URL_N8N}
- WEBHOOK_URL=${SERVICE_URL_N8N}
- N8N_HOST=${SERVICE_FQDN_N8N}
- N8N_PROTOCOL=${N8N_PROTOCOL:-https}
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE:-UTC}
- TZ=${TZ:-UTC}
- DB_SQLITE_POOL_SIZE=${DB_SQLITE_POOL_SIZE:-2}
- N8N_RUNNERS_ENABLED=true
- N8N_RUNNERS_MODE=external
- N8N_RUNNERS_BROKER_LISTEN_ADDRESS=${N8N_RUNNERS_BROKER_LISTEN_ADDRESS:-0.0.0.0}
- N8N_RUNNERS_BROKER_PORT=${N8N_RUNNERS_BROKER_PORT:-5679}
- N8N_RUNNERS_AUTH_TOKEN=${SERVICE_PASSWORD_N8N}
- N8N_NATIVE_PYTHON_RUNNER=${N8N_NATIVE_PYTHON_RUNNER:-true}
- N8N_RUNNERS_MAX_CONCURRENCY=${N8N_RUNNERS_MAX_CONCURRENCY:-5}
- N8N_BLOCK_ENV_ACCESS_IN_NODE=${N8N_BLOCK_ENV_ACCESS_IN_NODE:-true}
- N8N_GIT_NODE_DISABLE_BARE_REPOS=${N8N_GIT_NODE_DISABLE_BARE_REPOS:-true}
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=${N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS:-true}
- N8N_PROXY_HOPS=${N8N_PROXY_HOPS:-1}
- N8N_SKIP_AUTH_ON_OAUTH_CALLBACK=${N8N_SKIP_AUTH_ON_OAUTH_CALLBACK:-false}
volumes:
- n8n-data:/home/node/.n8n
healthcheck:
test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:5678/healthz"]
interval: 5s
timeout: 20s
retries: 10
task-runners:
image: n8nio/runners:2.47.7
environment:
- N8N_RUNNERS_TASK_BROKER_URI=${N8N_RUNNERS_TASK_BROKER_URI:-http://n8n:5679}
- N8N_RUNNERS_AUTH_TOKEN=${SERVICE_PASSWORD_N8N}
- N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT=${N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT:-15}
- N8N_RUNNERS_MAX_CONCURRENCY=${N8N_RUNNERS_MAX_CONCURRENCY:-5}
depends_on:
- n8n
healthcheck:
test:
- CMD-SHELL
- 'wget -qO- http://127.0.0.1:5680/healthz'
interval: 5s
timeout: 20s
retries: 10Le modèle fixe les images en 2.47.7 ; la version stable du jour est 2.48.6.
docker volume create n8n_data
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8nPour essayer n8n en local : le conteneur disparaît à l’arrêt, vos données restent dans le volume n8n_data. Ouvrez ensuite http://localhost:5678.
Docker Compose
Installer n8n
Le docker-compose.yml ci-dessus attend deux fichiers dans le même dossier : le .env et le script init-data.sh.
Créez le fichier .env
N8N_VERSIONfixe la version de n8n et de son exécuteur de tâches. Le fichier officiel fixe2.48.5; pour partir de la dernière stable, indiquez2.48.6. Changez les identifiants et le jeton avant le premier démarrage..env N8N_VERSION=2.48.5 POSTGRES_USER=changeUser POSTGRES_PASSWORD=changePassword POSTGRES_DB=n8n POSTGRES_NON_ROOT_USER=changeUser POSTGRES_NON_ROOT_PASSWORD=changePassword RUNNERS_AUTH_TOKEN=changeRunnerAuthTokenAjoutez init-data.sh
PostgreSQL l’exécute au premier démarrage pour créer l’utilisateur de la base de n8n.
init-data.sh #!/bin/bash set -e; if [ -n "${POSTGRES_NON_ROOT_USER:-}" ] && [ -n "${POSTGRES_NON_ROOT_PASSWORD:-}" ]; then psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL CREATE USER ${POSTGRES_NON_ROOT_USER} WITH PASSWORD '${POSTGRES_NON_ROOT_PASSWORD}'; GRANT ALL PRIVILEGES ON DATABASE ${POSTGRES_DB} TO ${POSTGRES_NON_ROOT_USER}; GRANT CREATE ON SCHEMA public TO ${POSTGRES_NON_ROOT_USER}; EOSQL else echo "SETUP INFO: No Environment variables given!" fiDémarrez
Terminal docker compose up -dOuvrez ensuite
http://localhost:5678. Pour arrêter :docker compose stop.
Mises à jour
Mettre à jour n8n
Une version mineure sort presque chaque semaine. La stable est faite pour la production ; la bêta est la plus récente et peut être instable.
Changez la version
Dans le
.env, la même valeur sert à n8n et à l’exécuteur : les deux images doivent rester à la même version..env N8N_VERSION=2.48.6Relancez
Dans le dossier du fichier compose :
Terminal docker compose pull docker compose down docker compose up -d
Les 5 dernières versions
| Version | Canal | Sortie le |
|---|---|---|
| 2.48.6 | stable | |
| 1.123.99 | branche 1.x | |
| 2.49.2 | bêta | |
| 2.48.5 | stable | |
| 1.123.98 | branche 1.x |
Avant une version majeure
Sauvegardez la base et le volume n8n_storage : il contient la clé de chiffrement de vos identifiants.
MCP
Brancher n8n à un agent IA
n8n contient son propre serveur MCP. Claude Code, Codex, Cursor ou VS Code s’y connectent pour chercher vos workflows, lancer ceux que vous exposez, en créer et en modifier.
Activez l’accès
Dans Settings › Instance-level MCP, choisissez Enable MCP access. Il faut être propriétaire ou administrateur de l’instance.
Connectez votre client
Le bouton Connect affiche l’adresse du serveur, qui se termine par
/mcp-server/http. Connexion par OAuth, recommandée, ou par clé d’API.Exposez vos workflows
Rien n’est exposé par défaut : activez chaque workflow dans Workflows enabled. Les clients voient seulement des aperçus des autres.
claude mcp add --transport http n8n https://<votre-domaine-n8n>/mcp-server/httpLancez ensuite /mcp dans Claude Code et choisissez n8n pour valider la connexion OAuth.
Derrière un proxy inverse
Laissez passer les en-têtes MCP-Protocol-Version, Mcp-Method et Mcp-Name, sinon le client se connecte mal.
Pour couper le MCP
Sur une instance auto-hébergée, N8N_DISABLED_MODULES=mcp retire les points d’accès et l’interface.
Nœud MCP Server Trigger
Un seul workflow devient un serveur MCP et n’expose que ses propres outils. Utile pour un comportement précis.
Nœud MCP Client Tool
Dans l’autre sens : un agent n8n appelle les outils d’un serveur MCP externe.
Serveurs MCP tiers prévus pour n8n
| Serveur et identifiant | Ce qu’il fait | Accès |
|---|---|---|
| CNAPS.ai MCP Serverai.cnaps/studio | Lance les modèles d’IA de CNAPS Studio sur simple demande. Fonctionne avec Claude, ChatGPT, n8n et Zapier. | Serveur distanthttps://mcp.cnaps.ai/mcp |
| ai-assistant-simpleai.smithery/cpretzinger-ai-assistant-simple | Outils Redis Stream à utiliser avec le nœud MCP Client de n8n. | Serveur distant hébergé par SmitheryJeton d’accès requis |
Automatisation et IA
Logiciels proches
D’autres logiciels de la rubrique Automatisation et IA, avec leur dernière version connue.
Toute la rubriqueModèles d’IA en local
Ollama
Assistant de code IA
OpenClaw
Agent IA autonome