Ce guide vous accompagne dans l'installation sur Infomaniak de n8n, une solution d'automatisation de flux de travail (workflow) puissante et extensible.

Préambule

• Contrairement à des outils comme Zapier ou Make, n8n, outil d'automatisation de workflow “fair-code”, peut être auto-hébergé, ce qui vous permet de garder un contrôle total sur vos données tout en connectant des centaines de services via une interface visuelle intuitive.

Installation de n8n

Prérequis

• Un site de type Node.js (v22 recommandé).
• Arrêter l'application Node.js depuis le dashboard de votre site Node.js avant toute opération technique.

Pour configurer votre hébergement (via le Manager Infomaniak):

1. Cliquez ici afin d'accéder à la gestion de votre site sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au site concerné:
   
3. Stoppez si nécessaire l'application, puis cliquez sur Gérer les paramètres avancés:
   
4. Cliquez sur l'onglet Node.js pour accéder aux réglages.
5. Sélectionnez une version récente (par exemple 24 ou supérieure).

6. Entrez la commande suivante en remplaçant https://domaine.xyz par l'adresse réelle de votre site:

   N8N_RELEASE_TYPE="stable" NODE_ENV="production" N8N_EDITOR_BASE_URL="https://domaine.xyz" WEBHOOK_URL="https://domaine.xyz" GENERIC_TIMEZONE="Europe/Zurich" /srv/customer/node_modules/.bin/n8n start

7. Indiquez 5678 pour le port d'écoute.
8. Activez la case "Définir la commande de construction".

9. Entrez la commande suivante:

   cd && npm install n8n@latest sqlite3

10. Cliquez sur Enregistrer:
    
11. Lancez l'étape du Build en cliquant sur le bouton Lancer sous Construction de l'application:
    
12. Sur la page principale, cliquez sur le bouton Démarrer (ou Redémarrer):
    
13. Patientez quelques minutes, puis rendez-vous sur l'URL de votre site (ex: https://domain.xyz).
14. Lors de votre première connexion, n8n vous demandera de créer un compte propriétaire pour sécuriser votre instance.

Votre instance n8n est désormais opérationnelle ! Vous pouvez commencer à créer vos automatisations.

Si vous rencontrez une erreur indiquant que le port est déjà utilisé lors du démarrage :

1. Changez temporairement la Version de Node.js dans les réglages (ex: passez de la v24 à la v23) et enregistrez. Cela force l'arrêt complet des processus.
2. Remettez la version souhaitée (v24) et enregistrez à nouveau.
3. Relancez l'application.

Mettre à jour n8n

Il est recommandé de maintenir régulièrement votre instance n8n à jour pour bénéficier des dernières fonctionnalités et correctifs de sécurité. Deux méthodes s'offrent à vous:

Méthode 1 : via le Manager Infomaniak (Recommandé)

Pour mettre à jour n8n, il suffit de relancer le processus de construction de l'application :

• Vérifiez au préalable dans les Paramètres avancés que votre commande de construction utilise bien la balise @latest :

  cd && npm install n8n@latest sqlite3

• Cliquez sur le bouton Lancer sous la section Construction de l'application.
• Important : ne supprimez pas le dossier node_modules ; le système se chargera de mettre à jour les paquets existants vers leur version la plus récente:
  

Méthode 2 : via une connexion SSH

Si vous préférez utiliser la ligne de commande, vous pouvez mettre à jour n8n directement depuis l'environnement Node.js:

1. Connectez-vous à votre serveur en SSH.

2. Accédez au répertoire de l'application et lancez la mise à jour :

   cd /srv/customer
   npm update n8n

3. Une fois l'opération terminée, redémarrez l'application depuis le Manager Infomaniak pour appliquer les changements.