N8N est une puissante plateforme d'automatisation de flux de travail qui vous permet de connecter différentes applications et services sans écrire une ligne de code. Son interface visuelle intuitive vous permet de créer des workflows complexes en quelques clics, transformant ainsi la façon dont vous gérez vos tâches quotidiennes.

Dans ce tutoriel, nous allons voir comment déployer N8N sur un VPS Linux KVM chez OuiHeberg en utilisant Docker. L'approche Docker présente plusieurs avantages majeurs par rapport à une installation classique :

  • Isolation complète : Chaque service fonctionne dans son propre conteneur, évitant les conflits de dépendances
  • Facilité de déploiement : Une seule commande pour tout installer
  • Simplicité de mise à jour : Mise à jour facilitée sans risque d'endommager votre système
  • Portabilité : Déployez la même configuration sur n'importe quel serveur supportant Docker
  •  

Prérequis

  • Un VPS Linux KVM chez OuiHeberg (Ubuntu ou Debian recommandé)
  • Accès SSH à votre serveur
  • Privilèges root ou utilisateur avec droits sudo
  • Connaissances de base en ligne de commande Linux

Étape 1 : Se connecter au VPS via SSH

Commencez par vous connecter à votre VPS en utilisant SSH :

ssh utilisateur@adresse_ip_de_votre_vps

Remplacez utilisateur par votre nom d'utilisateur (généralement root pour un VPS nouvellement créé) et adresse_ip_de_votre_vps par l'adresse IP fournie par OuiHeberg.

Étape 2 : Mettre à jour le système

Avant toute installation, assurez-vous que votre système est à jour :

apt update apt upgrade -y

Cette étape garantit que vous disposez des dernières versions des paquets et des correctifs de sécurité.

Étape 3 : Installer Docker et Docker Compose

Docker et Docker Compose sont essentiels pour notre installation :

curl -sSL https://get.docker.com/ | CHANNEL=stable bash

apt install docker-compose 
 

Vérifiez que l'installation s'est bien déroulée :

docker --version

docker-compose --version

Vous devriez voir les versions installées s'afficher sans erreur.

Étape 4 : Créer la configuration Docker pour N8N

Nous allons maintenant créer un fichier docker-compose.yml qui définira comment notre service N8N doit fonctionner :

Créer un répertoire pour N8N  : 

mkdir -p ~/n8n/data  

Créer le fichier docker-compose.yml  :

nano ~/n8n/docker-compose.yml

Copiez-collez ce contenu dans l'éditeur :

version: '3' services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=MotDePasseSecurise - NODE_ENV=production - WEBHOOK_URL=http://adresse_ip_de_votre_vps:5678 volumes: - ./data:/home/node/.n8n

Ce fichier configure :

  • L'image officielle de N8N
  • Le redémarrage automatique en cas de problème
  • L'exposition du port 5678
  • L'authentification de base pour sécuriser votre instance
  • La persistance des données dans le dossier data

N'oubliez pas de personnaliser :

  • Remplacez admin par votre nom d'utilisateur souhaité
  • Remplacez MotDePasseSecurise par un mot de passe fort
  • Remplacez adresse_ip_de_votre_vps par l'adresse IP de votre VPS

Sauvegardez le fichier avec Ctrl+O puis Entrée, et quittez l'éditeur avec Ctrl+X.

Étape 5 : Démarrer N8N avec Docker Compose

Lancez N8N en arrière-plan avec :

cd ~/n8n docker-compose up -d

L'option -d permet de lancer les conteneurs en mode détaché (en arrière-plan). Docker téléchargera automatiquement l'image N8N et démarrera le service selon votre configuration.

Étape 6 : Accéder à l'interface N8N

Votre instance N8N est maintenant opérationnelle ! Ouvrez votre navigateur et accédez à :

http://adresse_ip_de_votre_vps:5678

Vous serez accueilli par l'interface de connexion de N8N. Utilisez les identifiants que vous avez configurés dans le fichier docker-compose.yml.

Gestion de votre instance N8N

Voici quelques commandes utiles pour gérer votre instance N8N :

Consulter les logs

Pour voir les logs en temps réel :

cd ~/n8n docker-compose logs -f

Appuyez sur Ctrl+C pour quitter l'affichage des logs.

Arrêter N8N

cd ~/n8n docker-compose down

Redémarrer N8N

cd ~/n8n docker-compose restart

Mettre à jour N8N

Pour mettre à jour N8N vers la dernière version :

cd ~/n8n docker-compose pull docker-compose down docker-compose up -d

Configuration avancée (Optionnel)

Utilisation avec un nom de domaine et HTTPS

Pour une installation en production, il est fortement recommandé de configurer :

  1. Un nom de domaine pointant vers votre VPS
  2. Un certificat SSL pour sécuriser les connexions

Vous pouvez utiliser Traefik ou Nginx Proxy Manager comme reverse proxy pour gérer automatiquement les certificats SSL avec Let's Encrypt.

Sauvegarde des données

Les données de N8N sont stockées dans le dossier ~/n8n/data. Pour sauvegarder votre instance, il suffit de sauvegarder ce dossier.

Conclusion

Vous disposez maintenant d'une instance N8N fonctionnelle sur votre VPS OuiHeberg, prête à automatiser vos tâches quotidiennes. L'utilisation de Docker simplifie considérablement la maintenance et les mises à jour, vous permettant de vous concentrer sur la création de vos workflows.

N8N offre une multitude de possibilités d'intégration avec plus de 200 services différents, des API REST génériques, et même des scripts personnalisés. N'hésitez pas à explorer la documentation officielle pour découvrir tout le potentiel de cet outil d'automatisation.