Comment Mettre à Jour n8n en Self-Host
Guide étape par étape pour upgrader votre serveur n8n vers la dernière version avec Docker Compose
Vous utilisez n8n en self-host sur votre propre serveur ou via un hébergeur comme Hostinger ? Parfait ! Mais saviez-vous que les mises à jour de n8n sont fréquentes et apportent des améliorations cruciales en termes de sécurité, de nouvelles fonctionnalités et de corrections de bugs ?
Dans ce guide complet, nous allons voir ensemble comment passer de n’importe quelle version 2.x à la dernière version disponible (actuellement 2.1.1 ou supérieure). Suivez ces étapes et votre serveur sera à jour en quelques minutes !
🤔 C’est quoi le Self-Host ?
Le self-host (auto-hébergement) consiste à utiliser un serveur externe plutôt que le serveur officiel de n8n. Vous pouvez l’installer :
- Sur votre propre machine locale
- Sur un VPS (Virtual Private Server) chez un hébergeur comme Hostinger
- Sur n’importe quel serveur supportant Docker
💡 Pourquoi choisir le Self-Host plutôt que n8n Cloud ?
n8n Cloud (Officiel)
- 24$/mois – Plus cher
- Limité à 5 workflows actifs
- Gestion automatique des mises à jour
Self-Host (Recommandé)
- Tarif réduit – Beaucoup moins cher
- Workflows illimités – Aucune limite
- Mises à jour manuelles (ce guide !)
⚠️ Remarque importante : Si vous êtes encore en version 1.x, vous devez d’abord migrer vers la version 2.0 avant de pouvoir passer aux versions 2.1, 2.2, etc. Cette procédure ne fonctionne que pour les mises à jour au sein de la branche 2.x.
📋 Les Étapes de Mise à Jour
Accéder au Terminal
Connectez-vous à votre serveur VPS via le terminal. Sur Hostinger, vous pouvez y accéder directement depuis le tableau de bord.
💡 Le terminal vous permet de communiquer avec votre serveur via des lignes de commande.
Vérifier les Versions Docker
Commencez par vérifier que Docker est bien installé et à jour :
docker compose version
Détecter le Nom du Conteneur
Identifiez le nom exact de votre conteneur n8n :
📝 Notez le nom (ex: root-n8n-1), vous en aurez besoin plus tard.
Vérifier le Volume des Données
Vérifiez où sont stockées vos données et workflows :
Télécharger la Nouvelle Version
Récupérez l’image de la dernière version de n8n :
🔄 Remplacez 2.1.1 par la version souhaitée.
Localiser le Fichier Docker Compose
Trouvez le fichier de configuration Docker Compose :
find / -name « docker-compose.yml » 2>/dev/null # Si introuvable
Éditer le Fichier avec Nano
Modifiez le fichier pour forcer la nouvelle version :
Recherchez la ligne image: et modifiez-la :
📌 Raccourcis Nano :
• Ctrl + X → Quitter
• Y → Confirmer l’enregistrement
• Entrée → Valider
Arrêter et Redémarrer le Conteneur
Arrêtez le conteneur actuel, appliquez les changements et redémarrez :
docker compose down
# Mettre à jour et redémarrer
docker compose up -d
⚠️ Pendant cette étape, votre serveur n8n sera temporairement inaccessible (erreur 404).
Vérifier et Nettoyer
Vérifiez que la mise à jour a bien fonctionné et supprimez les anciennes images :
docker exec -it root-n8n-1 n8n –version
# Supprimer les anciennes images
docker image prune -a
📝 Récapitulatif des Commandes
docker –version
docker compose version
# 2. Lister les conteneurs
docker ps
# 3. Vérifier les volumes
docker volume ls
# 4. Télécharger la nouvelle version
docker pull n8nio/n8n:2.1.1
# 5. Éditer docker-compose.yml
nano docker-compose.yml
# 6. Arrêter le conteneur
docker compose down
# 7. Redémarrer avec la nouvelle version
docker compose up -d
# 8. Nettoyer les anciennes images
docker image prune -a
🎯 Conclusion
Félicitations ! 🎉 Vous savez maintenant comment mettre à jour votre serveur n8n en self-host. Cette procédure est valable pour toutes les mises à jour au sein de la branche 2.x.
N’oubliez pas de suivre régulièrement les nouvelles versions sur la documentation officielle de n8n pour bénéficier des dernières améliorations de sécurité et des nouvelles fonctionnalités.