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.
• En cas de besoin, des partenaires locaux et référencés par Infomaniak peuvent s'occuper de ces démarches : lancez un appel d'offres gratuit ; ils s'occupent de tout, vous libérant des détails techniques — découvrez aussi le rôle de l'hébergeur.

Installation de n8n

Prérequis

• Avoir installé un site vierge de type Node.js sur un hébergement Web ou Serveur Cloud Infomaniak.
• Arrêter votre application Node.js avant de procéder à l'installation !

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

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Stoppez si nécessaire l'application, puis cliquez sur Gérer sous 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.