Installer n8n sur un Raspberry Pi : le guide complet (Docker, ARM64)

Un Raspberry Pi qui traîne dans un tiroir peut devenir un serveur d'automatisation complet : n8n tourne très bien sur ARM64, l'image Docker officielle est publiée pour cette architecture, et la consommation de quelques watts en fait probablement le n8n self-hosted le moins cher à faire fonctionner en continu. Ce guide couvre l'installation de bout en bout — choix du modèle, préparation de l'OS, Docker, docker-compose.yml adapté au Pi — puis les questions qui fâchent : la carte SD, ce qu'un Pi tient réellement, et l'accès HTTPS depuis l'extérieur quand l'instance vit derrière une box. Si vous découvrez n8n sous Docker en général, commencez par notre guide d'installation n8n avec Docker : celui-ci en est le prolongement spécifique au Raspberry Pi.

Quel Raspberry Pi choisir (et pourquoi le 64 bits est obligatoire)

Deux modèles sont de bons candidats :

Modèle	RAM	Verdict pour n8n
Raspberry Pi 4	4 Go	Le minimum confortable pour n8n seul
Raspberry Pi 4	8 Go	De la marge pour n8n + d'autres services
Raspberry Pi 5	4-8 Go	Plus rapide, recommandé pour une nouvelle machine
Pi 3 et antérieurs	≤ 1 Go	À éviter : trop peu de RAM, et souvent en 32 bits

Le critère éliminatoire n'est pas la puissance mais l'architecture : l'image Docker officielle n8nio/n8n est publiée pour amd64 et arm64 uniquement. Un Raspberry Pi OS en 32 bits (armv7), même sur un Pi 4 pourtant capable de 64 bits, ne pourra pas lancer le conteneur — Docker répondra par une erreur de plateforme. Installez donc impérativement la variante 64-bit de l'OS.

L'idée d'utiliser le Pi comme serveur sérieux n'a d'ailleurs rien de farfelu : dès les débuts de la carte, Simon J. Cox et son équipe de l'université de Southampton ont assemblé « Iridis-pi », un cluster de calcul fonctionnel composé de 64 Raspberry Pi, décrit dans la revue Cluster Computing en 2014 (voir l'étude sur Google Scholar). Leur démonstration établissait précisément ce qui nous intéresse ici : le Pi est viable comme nœud serveur à très bas coût et très faible consommation. Un seul suffit largement pour n8n.

Préparer Raspberry Pi OS Lite 64-bit avec SSH

Le plus simple est l'outil officiel Raspberry Pi Imager (Windows, macOS, Linux) :

1. Choisissez l'image Raspberry Pi OS Lite (64-bit) — « Lite » car aucun bureau graphique n'est nécessaire pour un serveur, ce qui libère RAM et CPU.
2. Avant d'écrire la carte, ouvrez les réglages avancés de l'Imager : définissez le nom d'hôte (par exemple n8n-pi), activez SSH, créez votre utilisateur et renseignez le Wi-Fi si le Pi ne sera pas branché en Ethernet (l'Ethernet reste préférable pour un serveur).
3. Écrivez l'image, insérez la carte, branchez le Pi.

Après une minute ou deux, connectez-vous depuis votre machine :

ssh votre-utilisateur@n8n-pi.local

# Vérifie que l'OS est bien en 64 bits : doit répondre "aarch64"
uname -m

# Mises à jour système avant d'installer quoi que ce soit
sudo apt update && sudo apt full-upgrade -y

Si uname -m renvoie armv7l, l'OS installé est en 32 bits : reprenez l'étape d'écriture avec la bonne image, rien d'autre ne fonctionnera correctement.

Installer Docker et le plugin Compose

Le script officiel de Docker gère l'architecture ARM automatiquement :

curl -fsSL https://get.docker.com | sh

# Permet d'utiliser docker sans sudo (reconnectez-vous ensuite)
sudo usermod -aG docker $USER

# Vérifications
docker --version
docker compose version

Comme sur un VPS, utilisez bien docker compose (le plugin v2, sans tiret) et non l'ancien binaire docker-compose, déprécié.

Le docker-compose.yml pour Raspberry Pi

Sur un Pi, inutile de déployer PostgreSQL d'emblée : SQLite, la base par défaut de n8n, est un bon choix ici — un seul utilisateur, un volume d'exécutions modeste, et un service de moins à faire tenir dans la RAM. Créez un dossier /opt/n8n et placez-y ce fichier :

volumes:
  n8n_data:   # clé de chiffrement, config, base SQLite

services:
  n8n:
    # Image multi-arch : Docker sélectionne la variante arm64 automatiquement
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      # Fuseau des triggers planifiés (Cron, Schedule)
      - GENERIC_TIMEZONE=Europe/Paris
      - TZ=Europe/Paris
      # URL publique une fois l'accès distant en place (voir plus bas)
      - N8N_HOST=n8n.mondomaine.fr
      - WEBHOOK_URL=https://n8n.mondomaine.fr/
    volumes:
      - n8n_data:/home/node/.n8n

Puis :

cd /opt/n8n
docker compose up -d
docker compose logs -f n8n   # attendre "Editor is now accessible"

L'interface répond sur http://n8n-pi.local:5678 : créez le compte owner, et l'instance est opérationnelle. Le volume n8n_data contient la clé de chiffrement des credentials et le fichier SQLite : c'est lui qu'il faudra sauvegarder (voir plus bas). Si votre instance grossit au point de justifier PostgreSQL, le guide Docker général fournit le compose complet avec la base dédiée.

Carte SD ou SSD USB : la vraie question de fiabilité

C'est le point que la plupart des tutoriels éludent. n8n écrit dans sa base SQLite à chaque exécution de workflow : statut, données intermédiaires, historique. Sur une carte SD, ces petites écritures répétées usent les cellules de mémoire flash, et la corruption de carte SD est la panne numéro un des Raspberry Pi qui tournent 24 h/24. Symptômes classiques après quelques mois : système en lecture seule, base corrompue, instance qui ne redémarre plus.

Recommandations par ordre de robustesse :

1. SSD USB (recommandé) : un SSD SATA en boîtier USB 3 ou un petit SSD NVMe USB, généralement à moins de 50 €. Depuis le Pi 4, on peut démarrer directement sur USB : flashez l'OS sur le SSD plutôt que sur une carte SD et le problème disparaît entièrement, avec au passage des accès disque nettement plus rapides.
2. Carte SD de qualité + précautions : si vous restez sur SD, prenez une carte « High Endurance » (conçue pour les dashcams), et limitez la rétention d'historique de n8n avec EXECUTIONS_DATA_MAX_AGE pour réduire les écritures.
3. Dans tous les cas : des sauvegardes régulières du volume n8n_data, car un support de stockage finit toujours par lâcher.

Ce qu'un Raspberry Pi tient bien — et ses limites

Un Pi 4/5 avec 4 Go de RAM est parfaitement à l'aise sur les usages qui constituent le quotidien de la plupart des instances personnelles :

• Webhooks : recevoir des événements (formulaires, GitHub, Stripe…) et y réagir.
• Workflows planifiés : rapports, relances, synchronisations périodiques.
• Appels d'API légers : lire/écrire dans Notion, Google Sheets, Telegram, envoyer des emails.
• Domotique : c'est le terrain de jeu naturel du Pi — n8n dialogue très bien avec Home Assistant (webhooks et API REST) et MQTT, souvent sur le même réseau local, voire la même machine avec 8 Go de RAM.

Les limites sont tout aussi nettes :

• Workflows IA et RAG lourds : vectoriser des documents, faire tourner des chaînes d'agents, manipuler de longs contextes — la RAM part vite et le CPU ARM peine sur ces charges soutenues.
• Binary data volumineux : traiter des PDF de plusieurs dizaines de Mo, des vidéos ou des lots d'images charge mémoire et stockage au-delà du raisonnable pour un Pi.
• Forte concurrence : des dizaines d'exécutions simultanées relèvent d'un vrai serveur, éventuellement en mode queue.

Si vos besoins penchent de ce côté, un petit serveur dédié reste peu coûteux : notre guide pour choisir un VPS pour n8n self-hosted et l'analyse du coût réel d'un n8n self-hosted permettent de dimensionner sans surpayer. Le Pi et le VPS ne s'excluent d'ailleurs pas : beaucoup gardent le Pi pour la domotique locale et déportent les workflows lourds ailleurs.

Accès distant en HTTPS : Cloudflare Tunnel ou reverse proxy

Un Pi derrière une box internet pose deux problèmes qu'un VPS n'a pas : l'IP publique change (ou n'existe pas vraiment, avec le CGNAT de certains opérateurs), et ouvrir des ports sur sa box expose son réseau domestique.

Cloudflare Tunnel est la solution recommandée dans ce contexte : un petit démon (cloudflared, disponible en arm64) tourne à côté de n8n et établit une connexion sortante vers Cloudflare, qui publie votre sous-domaine en HTTPS. Aucun port ouvert sur la box, certificat géré automatiquement, IP du domicile invisible. La mise en place complète, ajout du service cloudflared au compose compris, est détaillée dans notre guide n8n + Cloudflare Tunnel.

L'alternative classique — un reverse proxy Traefik ou Caddy avec certificat Let's Encrypt — fonctionne aussi sur le Pi, mais suppose une IP publique joignable et la redirection des ports 80/443 sur la box. La procédure est la même que sur un VPS : suivez le guide n8n en HTTPS avec un nom de domaine. Dans les deux cas, pensez à aligner N8N_HOST et WEBHOOK_URL sur l'URL publique, sans quoi vos webhooks afficheront des adresses injoignables.

Et si l'instance ne sert que la domotique locale, le plus sûr reste de ne rien exposer du tout : n8n n'est alors joignable que sur le réseau de la maison (ou via un VPN type WireGuard/Tailscale).

Sauvegardes et mises à jour

Avec SQLite, tout tient dans le volume n8n_data : base de données, clé de chiffrement, configuration. Une sauvegarde se résume donc à archiver ce volume, idéalement vers une autre machine — un Pi n'est pas un endroit où stocker ses sauvegardes :

# Arrêt bref pour une copie cohérente de la base SQLite
docker compose stop n8n
docker run --rm -v n8n_n8n_data:/data -v $(pwd):/backup alpine \
  tar czf /backup/n8n-backup-$(date +%F).tar.gz -C /data .
docker compose start n8n

Copiez ensuite l'archive hors du Pi (scp, rclone vers un stockage cloud…) et planifiez le tout en cron. Si vous migrez un jour vers PostgreSQL, la logique de sauvegarde changera (pg_dump plutôt qu'une copie de fichier), mais le principe restera le même : base et clé de chiffrement, toujours ensemble.

Pour les mises à jour, la règle est la même que sur tout n8n Dockerisé : épinglez une version précise plutôt que latest, sauvegardez avant, puis docker compose pull && docker compose up -d. La procédure détaillée — et les pièges des sauts de versions — sont dans mettre à jour n8n sous Docker sans rien casser.

Le vrai argument : une instance qui coûte quelques watts

C'était déjà la conclusion de l'équipe d'Iridis-pi : le Raspberry Pi excelle là où le coût et la consommation priment. Un Pi 4 ou 5 en charge légère consomme de l'ordre de quelques watts — contre des dizaines pour un vieux PC recyclé en serveur — ce qui se traduit par quelques euros d'électricité par an pour une instance qui tourne en continu. Ajoutez un SSD USB et le ticket d'entrée matériel reste sous la barre des 150 €, sans abonnement mensuel.

Pour des webhooks, des workflows planifiés et de la domotique, c'est très difficile à battre. Et le jour où vos workflows dépassent la machine, tout ce que vous avez construit — le compose, les workflows exportés, les sauvegardes — se transporte tel quel vers un VPS : c'est précisément la portabilité que Docker garantit, et que notre guide d'installation n8n avec Docker décrit côté serveur.