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

docker-compose.yml
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.

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.

  1. Créez le fichier .env

    N8N_VERSION fixe la version de n8n et de son exécuteur de tâches. Le fichier officiel fixe 2.48.5 ; pour partir de la dernière stable, indiquez 2.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=changeRunnerAuthToken
  2. Ajoutez 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!"
    fi
  3. Démarrez

    Terminal
    docker compose up -d

    Ouvrez 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.

  1. 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.6
  2. Relancez

    Dans le dossier du fichier compose :

    Terminal
    docker compose pull
    docker compose down
    docker compose up -d

Les 5 dernières versions

VersionCanalSortie le
2.48.6stable
1.123.99branche 1.x
2.49.2bêta
2.48.5stable
1.123.98branche 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.

  1. Activez l’accès

    Dans Settings › Instance-level MCP, choisissez Enable MCP access. Il faut être propriétaire ou administrateur de l’instance.

  2. 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.

  3. 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 Code
claude mcp add --transport http n8n https://<votre-domaine-n8n>/mcp-server/http

Lancez 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 identifiantCe qu’il faitAccès
CNAPS.ai MCP Serverai.cnaps/studioLance 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-simpleOutils 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 rubrique

Domotique

Home Assistant

2026.11.2

Modèles d’IA en local

Ollama

0.40.16

Assistant de code IA

OpenClaw

version non connue

Agent IA autonome

Hermes Agent

version non connue