Pour installer n8n en auto-hébergé sur un VPS accessible en HTTPS, la procédure officielle de n8n pour un serveur Linux repose sur Docker Compose avec Traefik : un sous-domaine pointé vers le serveur, un fichier .env, un fichier compose.yaml, puis docker compose up -d. Le logiciel est gratuit (édition Community) ; vous payez seulement le serveur, de 6,49 € HT par mois chez Hetzner (gamme Regular Performance) à 80,50 $ par mois pour un cloud hébergé au Maroc chez Genious.
Ce guide suit pas à pas la procédure de docs.n8n.io, consultée le 9 novembre 2026, et ajoute ce que la page ne dit pas : la clé de chiffrement à sauvegarder, les mises à jour, et le choix du serveur pour une entreprise marocaine soumise à la loi 09-08. Si vous découvrez n8n, commencez par notre guide n8n en français, qui couvre les prix, la licence et la comparaison avec Zapier et Make.
Faut-il vraiment auto-héberger n8n ?
L'éditeur est clair : l'auto-hébergement est réservé aux utilisateurs à l'aise avec les serveurs. La documentation prévient que des erreurs peuvent entraîner perte de données, failles de sécurité ou interruptions, et recommande n8n Cloud à ceux qui n'ont pas cette expérience.
Les raisons d'héberger vous-même restent solides :
- le coût : l'édition Community est gratuite, alors que les offres Cloud sont facturées selon un volume d'exécutions ; seul le serveur vous coûte ;
- la maîtrise des données : vous choisissez le pays du serveur, ce qui compte au regard de la loi 09-08 ;
- la liberté technique : nœuds communautaires, accès aux fichiers locaux, base PostgreSQL à vous.
En contrepartie, la sécurité, les sauvegardes et les mises à jour deviennent votre travail. Si personne dans l'équipe ne peut s'en charger chaque mois, restez sur n8n Cloud.
Quel serveur choisir pour n8n ?
Un petit VPS Linux suffit pour démarrer avec quelques dizaines de workflows. Voici les options dont nous avons relevé les prix publics le 9 novembre 2026 :
| Option | Localisation des données | Prix affiché | Pour qui |
|---|---|---|---|
| Hetzner Cloud, gamme Cost-Optimized | Régions Hetzner (Allemagne, Finlande, entre autres) | à partir de 5,99 € HT par mois (affichée « actuellement indisponible » le 9 novembre 2026) | Tests, PME qui acceptent un hébergement hors du Maroc |
| Hetzner Cloud, Regular Performance | Idem | à partir de 6,49 € HT par mois | Production légère |
| Genious, Cloud Maroc « Moroccan Winter » (1 vCPU, 2 Go, 25 Go) | Datacenter au Maroc | 80,50 $ par mois | Données qui doivent rester au Maroc |
| Genious, Cloud Maroc « Moroccan Fall » (2 vCPU, 4 Go, 50 Go) | Datacenter au Maroc | 105,50 $ par mois | Production avec plus de charge |
| n8n Cloud | Infrastructure de l'éditeur | voir n8n.io/pricing | Équipes sans compétence serveur |
Un point à vérifier chez Genious : la fiche affiche une bande passante (« uplink ») de 1 Mbps sur ces offres. Une bande passante aussi faible peut ralentir l'interface, le téléchargement des images Docker et les gros fichiers ; demandez à Genious si la limite s'applique aussi au trafic entrant et quel est le coût d'une option supérieure.
Étape 1 : installer Docker et Docker Compose
Connectez-vous en SSH à votre serveur (Ubuntu ou Debian le plus souvent) et installez Docker Engine et le plugin Compose en suivant la documentation Docker pour votre distribution. Vérifiez ensuite :
docker --version
docker compose version
Facultatif, pour lancer Docker sans sudo :
sudo usermod -aG docker ${USER}
exec sg docker newgrp
Étape 2 : créer le sous-domaine
Chez votre registrar ou votre gestionnaire DNS, ajoutez un enregistrement A : nom n8n (ou le sous-domaine de votre choix), destination l'adresse IP du serveur. Attendez qu'il réponde avant de lancer Traefik, sinon le certificat HTTPS ne pourra pas être émis.
Étape 3 : préparer le fichier .env
Créez un dossier de projet et le fichier de configuration :
mkdir n8n-compose
cd n8n-compose
mkdir local-files
openssl rand -hex 32
La dernière commande affiche une chaîne aléatoire : gardez-la, elle servira de clé de chiffrement. Créez ensuite le fichier .env :
DOMAIN_NAME=votre-domaine.ma
SUBDOMAIN=n8n
GENERIC_TIMEZONE=Africa/Casablanca
SSL_EMAIL=admin@votre-domaine.ma
N8N_ENCRYPTION_KEY=collez-ici-la-chaine-generee
Deux réglages méritent une explication. GENERIC_TIMEZONE fixe le fuseau utilisé par les nœuds de planification (Schedule, Cron) : sans lui, n8n se cale sur New York et une relance programmée à 9 h part en réalité l'après-midi, heure de Casablanca. N8N_ENCRYPTION_KEY est une variable documentée par n8n : par défaut, n8n génère une clé au premier lancement et la range dans le dossier .n8n, mais la définir vous-même vous permet de la stocker dans votre gestionnaire de mots de passe dès le départ. Sans cette clé, une base restaurée ne peut plus déchiffrer vos identifiants (API, Odoo, WhatsApp). Cette variable ne s'utilise que sur une installation neuve : sur une instance existante, n8n refuse de démarrer si elle ne correspond pas à la clé déjà enregistrée dans le fichier config du dossier .n8n.
Étape 4 : écrire le fichier compose.yaml
Voici le fichier publié par n8n, avec une seule ligne ajoutée (N8N_ENCRYPTION_KEY). Il lance deux conteneurs : n8n, et Traefik, un proxy qui obtient le certificat HTTPS Let's Encrypt et redirige le trafic.
services:
traefik:
image: "traefik"
restart: always
command:
- "--api.insecure=true"
- "--providers.docker=true"
- "--providers.docker.exposedbydefault=false"
- "--entrypoints.web.address=:80"
- "--entrypoints.web.http.redirections.entryPoint.to=websecure"
- "--entrypoints.web.http.redirections.entrypoint.scheme=https"
- "--entrypoints.websecure.address=:443"
- "--certificatesresolvers.mytlschallenge.acme.tlschallenge=true"
- "--certificatesresolvers.mytlschallenge.acme.email=${SSL_EMAIL}"
- "--certificatesresolvers.mytlschallenge.acme.storage=/letsencrypt/acme.json"
ports:
- "80:80"
- "443:443"
volumes:
- traefik_data:/letsencrypt
- /var/run/docker.sock:/var/run/docker.sock:ro
n8n:
image: n8nio/n8n
restart: always
ports:
- "127.0.0.1:5678:5678"
labels:
- traefik.enable=true
- traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
- traefik.http.routers.n8n.tls=true
- traefik.http.routers.n8n.entrypoints=web,websecure
- traefik.http.routers.n8n.tls.certresolver=mytlschallenge
- traefik.http.middlewares.n8n.headers.SSLRedirect=true
- traefik.http.middlewares.n8n.headers.STSSeconds=315360000
- traefik.http.middlewares.n8n.headers.browserXSSFilter=true
- traefik.http.middlewares.n8n.headers.contentTypeNosniff=true
- traefik.http.middlewares.n8n.headers.forceSTSHeader=true
- traefik.http.middlewares.n8n.headers.SSLHost=${DOMAIN_NAME}
- traefik.http.middlewares.n8n.headers.STSIncludeSubdomains=true
- traefik.http.middlewares.n8n.headers.STSPreload=true
- traefik.http.routers.n8n.middlewares=n8n@docker
environment:
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
- N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
- N8N_PORT=5678
- N8N_PROTOCOL=https
- NODE_ENV=production
- N8N_WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
- TZ=${GENERIC_TIMEZONE}
- N8N_RESTRICT_FILE_ACCESS_TO=/files
- N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
volumes:
- n8n_data:/home/node/.n8n
- ./local-files:/files
volumes:
n8n_data:
traefik_data:
Le volume n8n_data contient la base SQLite et la clé de chiffrement ; le dossier local-files est partagé avec le serveur, accessible dans n8n sous /files. La documentation précise que N8N_WEBHOOK_URL existe depuis la version 2.30.0 ; sur une version plus ancienne, la variable s'appelle WEBHOOK_URL.
Étape 5 : démarrer et ouvrir le pare-feu
sudo docker compose up -d
Ouvrez ensuite https://n8n.votre-domaine.ma. n8n n'est accessible qu'en HTTPS. Au premier accès, il vous demande de créer le compte propriétaire : faites-le tout de suite, avant que quelqu'un d'autre ne tombe sur la page. Si rien ne répond, la documentation renvoie vers deux suspects : le pare-feu du serveur (les ports 80 et 443 doivent être ouverts) et la configuration DNS.
Pour arrêter les conteneurs : sudo docker compose stop.
Comment sauvegarder une instance n8n ?
C'est l'étape que la plupart des tutoriels oublient. D'après la page « Back up and restore » de n8n, une sauvegarde complète comprend deux éléments :
- le dossier
.n8n, qui contient la clé de chiffrement et, avec SQLite, la base elle-même. En Docker, il vit dans le volumen8n_data; - la base PostgreSQL, si vous en utilisez une, à sauvegarder avec ses propres outils.
Avec SQLite, la documentation demande d'arrêter n8n avant de copier le dossier, pour éviter une copie incohérente. Pour exporter en plus vos workflows et identifiants en JSON lisible, utilisez la CLI. Comme seul le dossier /files est relié au serveur dans notre configuration, écrivez-y les exports :
docker compose exec n8n n8n export:workflow --backup --output=/files/backups/workflows/
docker compose exec n8n n8n export:credentials --backup --output=/files/backups/credentials/
Si la commande renvoie une erreur de permission, donnez le dossier à l'utilisateur du conteneur : sudo chown -R 1000:1000 local-files. Gardez deux dossiers distincts : n8n signale un bug connu à l'import quand workflows et identifiants sont mélangés. Et retenez la limite : ces exports ne contiennent ni les utilisateurs, ni l'historique d'exécution, ni les variables, ni la clé de chiffrement. Ils servent à déplacer des workflows, pas à restaurer une instance entière.
Comment mettre à jour n8n ?
n8n publie une nouvelle version mineure presque chaque semaine. Le 9 novembre 2026, la version stable était la 2.46.7 et la beta la 2.47.3. L'éditeur conseille de mettre à jour au moins une fois par mois, de lire les notes de version avant, et de faire une sauvegarde complète. Avec Docker Compose :
cd n8n-compose
docker compose pull
docker compose down
docker compose up -d
Pour éviter les surprises, remplacez image: n8nio/n8n par une version précise, par exemple n8nio/n8n:2.46.7, et changez-la à la main quand vous êtes prêt. Revenir en arrière n'est pas toujours possible : une mise à jour peut modifier la base, d'où la sauvegarde préalable.
SQLite ou PostgreSQL ?
Par défaut, n8n auto-hébergé utilise SQLite, un fichier unique dans le volume. C'est suffisant pour une PME qui démarre. Passez à PostgreSQL si vous montez en charge ou si vous voulez activer le mode file d'attente (queue mode) avec plusieurs workers. n8n prend en charge PostgreSQL 16, 17 et 18 (état de la documentation en juillet 2026) via les variables DB_TYPE=postgresdb et DB_POSTGRESDB_*. Un fichier Compose prêt à l'emploi avec PostgreSQL est publié dans le dépôt GitHub n8n-io/n8n-hosting.
Héberger n8n au Maroc ou à l'étranger ?
La question se pose dès que vos workflows manipulent des noms, téléphones ou e-mails de clients. Ces traitements relèvent de la loi 09-08 relative à la protection des personnes physiques à l'égard du traitement des données à caractère personnel, contrôlée par la CNDP. Deux articles comptent ici :
- l'article 12, qui soumet les traitements à une déclaration préalable auprès de la CNDP, ou à une autorisation pour certaines catégories de données (les traitements comportant le numéro de CIN, par exemple) ;
- l'article 43, qui n'autorise le transfert de données vers un pays étranger que si ce pays assure un niveau de protection suffisant ; l'article 44 prévoit des exceptions, dont le consentement exprès de la personne ou une autorisation de la CNDP.
Un VPS en Allemagne n'est donc pas interdit, mais il fait entrer vos flux dans ce cadre de transfert. Un serveur au Maroc, comme le cloud de Genious, garde les données hébergées dans le pays, au prix d'un abonnement nettement plus cher que chez Hetzner. Notez que l'hébergement du serveur ne règle pas tout : si un workflow envoie les données à une API d'IA hébergée aux États-Unis, ce flux est lui aussi un transfert. Vérifiez votre cas auprès de la CNDP avant de brancher une base clients.
Et après l'installation ?
Une instance qui tourne n'automatise encore rien. Les premiers workflows utiles sont souvent les mêmes : formulaire du site vers CRM, relance de devis, message WhatsApp vers commande dans Odoo. Notre page automatisation des processus pour les entreprises marocaines présente notre façon de les cadrer. AY Automate accompagne les entreprises marocaines, en français, de l'installation de n8n à la maintenance des workflows en production ; le détail de l'offre est sur notre page automatisation des processus.
Questions fréquentes
n8n auto-hébergé est-il vraiment gratuit ? Oui, l'édition Community auto-hébergée est gratuite et publiée sur GitHub. Vous payez le serveur, à partir de 6,49 € HT par mois chez Hetzner (prix relevé le 9 novembre 2026). La licence Sustainable Use autorise l'usage pour vos besoins internes ; revendre n8n en tant que service à des clients demande un accord avec l'éditeur.
Quelle configuration minimale pour un VPS n8n ? Un VPS d'entrée de gamme sous Linux suffit pour démarrer avec SQLite et quelques dizaines de workflows. L'offre cloud marocaine la moins chère de Genious, par exemple, propose 1 vCPU, 2 Go de RAM et 25 Go de disque. Prévoyez plus de mémoire si vous traitez de gros fichiers ou beaucoup d'exécutions en parallèle.
Peut-on installer n8n sans Docker ?
Pour l'instant, une installation npm reste possible sur la version 2.x, mais n8n annonce qu'à partir de la version 3.0, il ne sera plus distribué que via Docker. Les nouvelles installations doivent donc passer par Docker. Docker isole l'application, simplifie les mises à jour (docker compose pull) et garde les données dans un volume facile à sauvegarder.
Que se passe-t-il si je perds la clé de chiffrement ?
Vos identifiants enregistrés deviennent illisibles. n8n chiffre les identifiants dans la base avec cette clé ; sans elle, une sauvegarde restaurée ne peut pas les déchiffrer et il faut ressaisir chaque connexion. Stockez N8N_ENCRYPTION_KEY hors du serveur, dans un gestionnaire de mots de passe.
Faut-il héberger n8n au Maroc pour respecter la loi 09-08 ? Ce n'est pas obligatoire, mais un serveur à l'étranger fait entrer vos flux de données personnelles dans les règles de transfert des articles 43 et 44 de la loi 09-08. Un hébergement au Maroc simplifie ce point. Dans les deux cas, la déclaration préalable du traitement auprès de la CNDP reste à vérifier.
À quelle fréquence mettre n8n à jour ? Au moins une fois par mois, selon la documentation de n8n. L'éditeur sort une version mineure presque chaque semaine ; sauvegardez avant chaque mise à jour et lisez les notes de version pour repérer les changements incompatibles.
Sources (lues le 9 novembre 2026) : n8n, Use Docker Compose, n8n, Back up and restore, n8n, Update n8n, n8n, Install with Docker, n8n, Set a custom encryption key, n8n, Choose n8n's database, n8n pricing, Hetzner Cloud, Genious, Cloud Hosting in Morocco, loi 09-08, texte publié par le ministère de la Justice, n8n, One-line setup.






