0. Pré‑requis

• macOS Ventura, Sonoma ou version récente, sur Mac Intel ou Apple Silicon (M1/M2/M3).
• Compte utilisateur avec droits administrateur sur le Mac.
• Au moins 8 Go de RAM conseillés pour Docker Desktop et n8n.
• Connexion Internet pour télécharger Docker Desktop et l’image n8n.

1. Installer Docker Desktop sur macOS

1. Télécharger Docker Desktop pour Mac
   Rendez‑vous sur la page officielle “Get Docker Desktop”, choisissez la version pour macOS (Intel ou Apple Silicon) et téléchargez le fichier Docker.dmg.
2. Installer l’application Docker
   Ouvrez le fichier Docker.dmg, puis faites glisser l’icône Docker dans le dossier Applications comme indiqué dans la fenêtre d’installation.
3. Lancer Docker Desktop
   Ouvrez le dossier Applications, double‑cliquez sur Docker.app, acceptez les conditions d’utilisation et saisissez éventuellement votre mot de passe macOS pour autoriser l’installation des composants.
4. Vérifier l’installation
   Une fois Docker démarré (icône baleine dans la barre de menus), ouvrez l’application Terminal et exécutez :
   docker --version
   Si une version s’affiche, Docker est bien installé. Vous pouvez aussi tester rapidement avec :
   docker run hello-world

2. Préparer le dossier n8n et le fichier docker-compose

1. Créer un dossier dédié
   Dans le Terminal, créez un dossier dans votre répertoire utilisateur, par exemple :
   mkdir -p ~/n8n-docker
cd ~/n8n-docker
2. Créer le fichier docker-compose.yml
   Toujours dans le Terminal, lancez un éditeur (par exemple nano) :
   nano docker-compose.yml
   Collez ensuite la configuration de base suivante inspirée de la documentation n8n :

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=motdepasseFort123
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - TZ=Europe/Paris
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:
    

Ce fichier décrit un service n8n, publié sur le port 5678, protégé par une authentification basique, avec un volume Docker n8n_data pour conserver vos workflows et données entre les redémarrages.

3. Démarrer n8n avec Docker sur macOS

1. Se placer dans le dossier de projet
   Dans le Terminal :
   cd ~/n8n-docker
2. Lancer n8n en arrière‑plan
   Exécutez :
   docker compose up -d
   Docker télécharge l’image n8n si nécessaire, crée le conteneur et le démarre en tâche de fond.
3. Vérifier que le conteneur tourne
   Tapez :
   docker ps
   Vous devez voir une ligne avec l’image n8n et le port 0.0.0.0:5678->5678/tcp.
4. Accéder à l’interface n8n
   Ouvrez votre navigateur (Safari, Chrome, etc.) et rendez‑vous sur :
   http://localhost:5678
   Connectez‑vous avec les identifiants définis dans les variables d’environnement (par exemple admin / motdepasseFort123). La première connexion peut vous demander de compléter quelques informations de base.

4. Démarrer, arrêter et mettre à jour n8n

• Arrêter n8n (depuis ~/n8n-docker) :
  docker compose down
  Le conteneur est supprimé, mais les données sont conservées dans le volume n8n_data.
• Relancer n8n :
  docker compose up -d
• Mettre à jour n8n :
  cd ~/n8n-docker
docker compose pull
docker compose up -d
  Docker récupère la nouvelle image n8n et redémarre le service en conservant vos workflows.

5. Remarques

Avec cette configuration Docker Desktop + n8n, votre Mac devient un environnement local suffisant pour des travaux pratiques, des démonstrations de workflows ou des prototypes d’agents IA, sans abonnement ni serveur externe. Le même fichier docker-compose.yml pourra être réutilisé sur un VPS ou un serveur Linux si vous souhaitez passer à une mise en production.