Comment installer n8n sur CasaOS ?

n8n est un outil d’au­to­ma­ti­sa­tion des workflows qui vous permet de connecter dif­fé­rents services et ap­pli­ca­tions entre eux. Associé à CasaOS, il peut être installé et ad­mi­nis­tré fa­ci­le­ment depuis une interface graphique. Dans ce guide, découvrez étape par étape comment installer n8n sur CasaOS et le con­fi­gu­rer pour vos workflows d’au­to­ma­ti­sa­tion.

Étape 1 : vérifier les prérequis et choisir le serveur adapté

Avant de commencer l’ins­tal­la­tion, vous avez besoin d’un en­vi­ron­ne­ment adapté sur lequel CasaOS et n8n peuvent s’exécuter. En principe, les prérequis suivants doivent être remplis :

• Serveur Linux (re­com­mandé : Ubuntu 22.04 ou 24.04)
• Accès root ou droits sudo
• Connexion Internet stable
• Fa­cul­ta­tif : un nom de domaine pour permettre ul­té­rieu­re­ment un accès depuis l’extérieur

Comme n8n nécessite plus ou moins de res­sources selon l’usage, vous devez choisir un serveur adapté. Les cas d’usage suivants vous aideront à dé­ter­mi­ner la con­fi­gu­ra­tion de départ la plus adaptée.

Cas d’usage 1 : par­ti­cu­liers ou petites au­to­ma­ti­sa­tions

Si vous souhaitez utiliser n8n pour des projets per­son­nels, par exemple pour au­to­ma­ti­ser des emails, des réseaux sociaux ou de petits trai­te­ments de données, un petit serveur est largement suffisant. Les workflows n8n typiques restent ici plutôt simples et ne s’exécutent pas en continu à haute fréquence. Vous pouvez par exemple au­to­ma­ti­ser des flux RSS, connecter de simples API ou créer des no­ti­fi­ca­tions. La charge est faible, de sorte que des systèmes d’entrée de gamme bon marché suffisent. L’important, dans ce cas, est surtout de disposer de suf­fi­sam­ment de RAM pour que n8n fonc­tionne de manière stable. La puissance du CPU joue ici un rôle se­con­daire.

Cas d’usage 2 : startups et projets en crois­sance

Pour des startups ou des projets en dé­ve­lop­pe­ment, vous devriez prévoir un peu plus de puissance. Dès que plusieurs workflows s’exécutent en parallèle ou que des API externes sont utilisées de manière plus intensive, la charge système augmente. Les scénarios typiques sont le trai­te­ment au­to­ma­tisé de leads, la syn­chro­ni­sa­tion avec un CRM ou des outils internes simples. Dans ce cas, vous bé­né­fi­ciez déjà de davantage de cœurs CPU et de mémoire vive. Surtout si vous prévoyez d’utiliser n8n ré­gu­liè­re­ment ou de l’étendre par la suite, il peut être judicieux d’opter dès le départ pour un serveur un peu plus per­for­mant.

Cas d’usage 3 : PME et uti­li­sa­tion pro­fes­sion­nelle

Dans les petites et moyennes en­tre­prises, n8n est souvent utilisé pour des processus critiques pour l’activité. Il s’agit notamment de flux de données au­to­ma­ti­sés, d’in­té­gra­tions entre systèmes ou de workflows internes. Ici, la stabilité est es­sen­tielle. Davantage de RAM permet d’exécuter plusieurs processus en parallèle sans créer de goulets d’étran­gle­ment. Il est également re­com­mandé de prévoir suf­fi­sam­ment d’espace de stockage, en par­ti­cu­lier lorsque des logs, des données ou des fichiers sont traités.

Cas d’usage 4 : ap­pli­ca­tions évo­lu­tives et forte charge

Si vous utilisez n8n de manière intensive, par exemple pour des processus pilotés par les données, de nombreux workflows pa­ral­lèles ou des in­té­gra­tions plus im­por­tantes, vous devriez miser sur des systèmes per­for­mants. Dans de tels scénarios, de nombreux processus s’exécutent souvent en même temps, parfois en continu. Une puissance CPU élevée et une quantité im­por­tante de RAM sont ici es­sen­tielles, surtout en cas de pics de charge tem­po­raires. L’espace de stockage doit également être di­men­sionné gé­né­reu­se­ment afin d’absorber du­ra­ble­ment la crois­sance et les volumes de données.

Tableau ré­ca­pi­tu­la­tif : nos re­com­man­da­tions de serveurs

Étape 2 : installer CasaOS

Avant de pouvoir commencer l’ins­tal­la­tion de n8n, vous avez d’abord besoin de CasaOS comme interface de gestion. CasaOS est une pla­te­forme con­vi­viale qui vous permet d’installer et gérer fa­ci­le­ment des ap­pli­ca­tions comme n8n en quelques clics, sans devoir vous plonger en pro­fon­deur dans Docker ou des commandes serveur complexes.

Vous devez d’abord vous connecter à votre serveur. Cela se fait gé­né­ra­le­ment via SSH. Pour cela, ouvrez un terminal puis saisissez la commande suivante :

ssh root@VOTRE-IP-SERVEUR

Remplacez VOTRE-IP-SERVEUR par l’adresse IP réelle de votre serveur. Confirmez ensuite la connexion et saisissez votre mot de passe.

Dès que vous êtes connecté à votre serveur, vous pouvez installer CasaOS avec une seule commande :

curl -fsSL https://get.casaos.io | sudo bash

Cette commande té­lé­charge le script d’ins­tal­la­tion officiel et l’exécute au­to­ma­ti­que­ment. Tous les com­po­sants né­ces­saires sont alors installés et con­fi­gu­rés. L’ins­tal­la­tion se déroule en­tiè­re­ment de manière au­to­ma­tique. Pendant ce temps, vous verrez dif­fé­rentes sorties dans le terminal. En général, cette étape ne dure que quelques minutes.

Close

Après une ins­tal­la­tion réussie, vous pouvez ouvrir CasaOS di­rec­te­ment dans le na­vi­ga­teur. Pour cela, saisissez dans la barre d’adresse :

http://VOTRE-IP-SERVEUR

Étape 3 : se connecter à CasaOS et com­prendre l’interface

En sai­sis­sant l’adresse IP du serveur dans votre na­vi­ga­teur, l’interface uti­li­sa­teur de CasaOS s’affiche. Lors du premier démarrage, vous serez au­to­ma­ti­que­ment guidé à travers la con­fi­gu­ra­tion initiale. Dé­fi­nis­sez alors un uti­li­sa­teur ainsi qu’un mot de passe sécurisé et connectez-vous ensuite. Après la connexion, vous accédez di­rec­te­ment au tableau de bord central de CasaOS. L’interface est vo­lon­tai­re­ment simple et claire, afin que vous puissiez vous y retrouver ra­pi­de­ment, même sans con­nais­sances préa­lables.

Les zones prin­ci­pales sont les suivantes :

• App Store : ici, vous pouvez installer de nouvelles ap­pli­ca­tions comme n8n en quelques clics
• Installed Apps : dans cette section, vous voyez toutes les ap­pli­ca­tions déjà ins­tal­lées et en cours d’exécution
• Vue d’ensemble du système : elle vous indique la charge actuelle de votre serveur, notamment l’uti­li­sa­tion du pro­ces­seur, de la mémoire vive et de l’espace de stockage.

Vous disposez ainsi d’un aperçu rapide de votre système et pouvez gérer vos ap­pli­ca­tions de manière cen­tra­li­sée.

Close

Étape 4 : installer n8n via l’App Store

Après vous être connecté à CasaOS, vous pouvez installer n8n di­rec­te­ment via l’interface graphique. Pour cela, ouvrez d’abord l’App Store, que vous trouverez dans le tableau de bord de CasaOS. En général, cette section est bien visible sur la page d’accueil. Saisissez ensuite le terme « n8n » dans la barre de recherche. Dès que l’ap­pli­ca­tion apparaît dans les résultats, cliquez dessus.

Close

À l’étape suivante, une vue détaillée de l’ap­pli­ca­tion s’affiche. Cliquez ici sur le bouton « Installer » pour lancer l’ins­tal­la­tion.

Close

CasaOS prend alors en charge l’ins­tal­la­tion de n8n avec Docker et s’occupe au­to­ma­ti­que­ment du té­lé­char­ge­ment de l’image Docker, de la mise en place du conteneur Docker ainsi que de la con­fi­gu­ra­tion des pa­ra­mètres de base. Après un court instant, n8n est installé et s’affiche dans la vue d’ensemble de vos ap­pli­ca­tions ins­tal­lées. Vous pouvez ensuite lancer et ouvrir l’ap­pli­ca­tion di­rec­te­ment.

Al­ter­na­tive : ins­tal­la­tion manuelle via Docker (ap­pli­ca­tion per­son­na­li­sée)

Si n8n n’est pas dis­po­nible dans l’App Store ou si vous souhaitez avoir davantage de contrôle sur la con­fi­gu­ra­tion, vous pouvez également ajouter l’ap­pli­ca­tion ma­nuel­le­ment en tant que « Custom App ». Pour cela, ouvrez l’App Store et cliquez sur « Custom Install » ou « + Add App » (selon la version de CasaOS). Choi­sis­sez ensuite l’option per­met­tant d’ajouter une ap­pli­ca­tion via une con­fi­gu­ra­tion Docker (Compose / YAML). Un for­mu­laire de saisie s’ouvre alors, dans lequel vous pouvez entrer votre con­fi­gu­ra­tion. Insérez-y le code suivant :

services:
    n8n:
        image: docker.n8n.io/n8nio/n8n
        restart: unless-stopped
        ports:
            - "5678:5678"
        environment:
            - N8N_HOST=n8n.votredomaine.fr
            - N8N_PORT=5678
            - N8N_PROTOCOL=http
            - GENERIC_TIMEZONE=Europe/Paris
        volumes:
            - n8n_data:/home/node/.n8n
volumes:
    n8n_data:

Cette con­fi­gu­ra­tion permet de démarrer n8n en tant que conteneur, de rendre le port standard 5678 ac­ces­sible et de stocker les données de manière per­ma­nente dans un volume. Après avoir inséré le code, validez la saisie et lancez l’ins­tal­la­tion.

CasaOS crée ensuite au­to­ma­ti­que­ment le conteneur et ajoute l’ap­pli­ca­tion à votre vue d’ensemble. Au bout de quelques instants, n8n est prêt à l’emploi.

Étape 5 : démarrer et ouvrir n8n

Une fois l’ins­tal­la­tion de n8n sur CasaOS terminée, vous pouvez démarrer n8n di­rec­te­ment depuis l’interface de CasaOS. Pour cela, allez dans le tableau de bord, dans la section « Installed Apps ». Vous y verrez toutes les ap­pli­ca­tions ac­tuel­le­ment ins­tal­lées sur votre serveur. Re­cher­chez n8n dans la liste. Si n8n n’est pas encore en cours d’exécution, cliquez sur « Start ». Dans la plupart des cas, l’ap­pli­ca­tion démarre toutefois au­to­ma­ti­que­ment après l’ins­tal­la­tion.

Close

Dès que n8n est actif, vous pouvez accéder à son interface dans votre na­vi­ga­teur en ouvrant un nouvel onglet et en sai­sis­sant l’adresse suivante :

http://VOTRE-IP-SERVEUR:5678

Remplacez VOTRE-IP-SERVEUR par l’adresse IP réelle de votre serveur. Le port 5678 est le port standard de n8n et doit im­pé­ra­ti­ve­ment être indiqué.

Si tout est cor­rec­te­ment configuré, l’interface uti­li­sa­teur de n8n s’ouvre di­rec­te­ment. Au premier démarrage, vous verrez gé­né­ra­le­ment l’éditeur n8n ou une courte page de con­fi­gu­ra­tion. À partir de ce moment, vous pouvez commencer à créer votre premier workflow.

Étape 6 : con­fi­gu­ra­tion de base pour un fonc­tion­ne­ment en pro­duc­tion

Après avoir installé et démarré n8n avec succès, vous devriez, dans un second temps, effectuer quelques réglages de base. Ils sont par­ti­cu­liè­re­ment im­por­tants si vous souhaitez utiliser n8n non seulement pour des tests, mais aussi de manière durable et fiable. Sans cette con­fi­gu­ra­tion, des problèmes peuvent survenir plus tard, par exemple avec les Webhooks, l’accès externe ou la sécurité générale de votre ins­tal­la­tion.

Con­fi­gu­rer un (sous-)domaine

Par défaut, n8n n’est ac­ces­sible que via l’adresse IP de votre serveur et une connexion HTTP non chiffrée. Pour une uti­li­sa­tion en pro­duc­tion, cela n’est pas suffisant. Vous devriez plutôt accéder à n8n via un domaine fixe et sécuriser l’accès avec HTTPS. La connexion est ainsi chiffrée et nettement plus sûre, et de nom­breuses in­té­gra­tions et Webhooks fonc­tion­nent aussi de façon plus fiable.

Con­fi­gu­rez d’abord un domaine propre ou un sous-domaine, par exemple n8n.votredomaine.fr. Ce domaine doit pointer vers l’adresse IP de votre serveur via un en­re­gis­tre­ment DNS (en­re­gis­tre­ment A). Une fois le domaine cor­rec­te­ment relié, vous pourrez à l’avenir accéder à n8n fa­ci­le­ment via une URL claire et mé­mo­ri­sable, au lieu d’avoir à utiliser une adresse IP.

Mettre en place un reverse proxy

Pour que les requêtes adressées à ce domaine soient cor­rec­te­ment trans­mises à n8n, vous avez en plus besoin d’un reverse proxy. Celui-ci agit comme un in­ter­mé­diaire entre Internet et votre ap­pli­ca­tion. Des solutions typiques sont par exemple nginx ou Caddy. Le reverse proxy s’assure que les requêtes entrantes vers votre domaine sont reçues, puis trans­mises en interne vers le port de n8n. Il prend également en charge la mise en place et la gestion des cer­ti­fi­cats HTTPS.

Pour le chif­fre­ment, vous pouvez utiliser Let’s Encrypt. Il s’agit d’un service gratuit qui émet au­to­ma­ti­que­ment des cer­ti­fi­cats SSL valides et les re­nou­velle ré­gu­liè­re­ment. De nombreux reverse proxys prennent déjà en charge Let’s Encrypt na­ti­ve­ment, de sorte que la con­fi­gu­ra­tion est souvent très simple en pratique. Grâce à HTTPS, vous vous assurez que votre connexion est protégée et que divers na­vi­ga­teurs ne classent pas votre ap­pli­ca­tion comme non sécurisée.

Définir les variables d’en­vi­ron­ne­ment

De plus, vous devriez définir quelques variables d’en­vi­ron­ne­ment im­por­tantes pour que n8n re­con­naisse cor­rec­te­ment l’adresse à laquelle il est ac­ces­sible et comment les Webhooks doivent être générés. Une con­fi­gu­ra­tion typique ressemble à ceci :

N8N_HOST=n8n.votredomaine.fr
N8N_PROTOCOL=https
N8N_WEBHOOK_URL=https://n8n.votredomaine.fr/
N8N_PROXY_HOPS=1

Ces valeurs indiquent à n8n que l’ap­pli­ca­tion est ac­ces­sible via votre domaine et une connexion HTTPS. Si vous exécutez n8n avec CasaOS, vous pouvez définir ces variables di­rec­te­ment dans les pa­ra­mètres de l’ap­pli­ca­tion. Pour cela, ouvrez la section « Installed Apps », sé­lec­tion­nez n8n et saisissez les valeurs dans le volet dédié aux variables d’en­vi­ron­ne­ment. En­re­gis­trez ensuite les mo­di­fi­ca­tions et re­dé­mar­rez le conteneur pour que la con­fi­gu­ra­tion soit prise en compte.

Pour une uti­li­sa­tion pro­fes­sion­nelle, vous devriez également définir la variable d’en­vi­ron­ne­ment N8N_EN­CRYP­TION_KEY. Cette clé est utilisée par n8n pour chiffrer les données sensibles, comme les iden­ti­fiants d’accès ou les clés d’API. Si aucune clé per­son­na­li­sée n’est définie, n8n en génère au­to­ma­ti­que­ment une de manière aléatoire. Cela peut entraîner, lors d’un re­dé­mar­rage ou d’un chan­ge­ment de conteneur, des problèmes d’accès aux iden­ti­fiants en­re­gis­trés.