SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Installer l’agent IA Nod de n8n sur un VPS

Installez Nod, l’agent Apache-2.0 de l’équipe n8n, avec Docker Compose sur un VPS. Gardez le port 4310 privé et sauvegardez la clé Vault avant usage.

Ce qu’est Nod et ce que vous allez construire

Nod est un agent IA personnel développé par l’équipe à l’origine de n8n. Vous pouvez l’exécuter sur un VPS avec le kit Docker Compose disponible dans son propre dépôt. Ce guide utilise le kit avec le tag nod-v0.8.1 et garde l’application sur un port privé. Vous y accédez via un tunnel SSH ou en HTTPS. La sauvegarde fait partie de l’installation, car les identifiants enregistrés sont irrécupérables sans une clé.

Le README décrit Nod comme un agent disposant de son propre ordinateur et de son propre navigateur : « Il poursuit le paiement des factures, prépare vos appels et annule des essais sur de vrais sites web. Il s’exécute sur votre machine avec le modèle de votre choix et vous demande votre confirmation avant d’agir à votre place. » Vous lui parlez dans une seule conversation. Il dispose de son propre espace de travail Linux et d’un navigateur, et se connecte à Gmail, Calendar, Slack, Notion et au web.

Deux faits permettent de définir les attentes avant toute installation. Premièrement, le README qualifie Nod de « research preview ». Le site de documentation affiche également une bannière « Early preview » indiquant : « Attendez-vous à des aspérités et à des changements incompatibles. » Deuxièmement, le README indique que le contrôle de sécurité de Nod « repose sur le jugement d’un modèle ». Considérez-le comme un outil en phase de preview. Donnez-lui uniquement accès aux comptes avec lesquels vous acceptez de faire des tests.

Un VPS convient à Nod pour une raison simple. La documentation indique que les tâches planifiées s’exécutent uniquement lorsque la machine qui exécute Nod est allumée. Un ordinateur portable se met en veille. Un serveur reste allumé.

Différences entre Nod et un workflow d’agent IA n8n

Nod n’est pas n8n AI Assistant, et vous n’avez pas besoin de n8n pour l’exécuter. Le README répond à la question « Ai-je besoin de n8n ? » par : « Non. Nod est sa propre application, développée par l’équipe à l’origine de n8n. Ce n’est pas n8n AI Assistant. »

La documentation n8n décrit le nœud AI Agent ainsi : « Connectez un modèle de chat et un ou plusieurs outils. L’agent décide quels outils appeler pour effectuer une tâche. » Vous créez cet agent dans l’éditeur n8n et devez lui connecter au moins un sous-nœud d’outil. Si c’est ce dont vous avez besoin, créer un workflow avec un nœud AI Agent dans n8n explique la procédure. Auto-héberger n8n sur un VPS avec Docker et HTTPS vous fournit le serveur n8n sur lequel le créer.

Voici comment nous interprétons les deux ensembles de documentation. Un nœud AI Agent est un agent que vous concevez nœud par nœud dans n8n. Nod est une application de chat complète, avec son propre espace de travail et son propre navigateur. Vous lui attribuez des tâches en langage naturel. Aucune page du fournisseur ne compare les deux produits. Considérez donc ce résumé comme une synthèse, et non comme une position officielle.

Les deux peuvent fonctionner ensemble. La page n8n de Nod indique : « Connectez votre n8n une seule fois, puis demandez-le par son nom dans le chat. » Nod peut alors créer « un agent n8n avec les outils et le canal que vous indiquez ». Si votre demande ne mentionne pas n8n, Nod utilise ses propres tâches et planifications.

La licence : Nod est sous Apache-2.0, n8n ne l’est pas

Le dépôt de Nod, github.com/n8n-io/nod, est distribué sous Apache License 2.0, et le titulaire des droits d’auteur est n8n GmbH. Le pied de page du README indique « Copyright 2026 n8n GmbH · Apache License 2.0 ». Les ressources tierces incluses, comme la police Geist, les logos des fournisseurs et les composants du runtime desktop, restent soumises à leurs propres conditions de licence.

n8n utilise lui-même une autre licence. Son code, à l’exception des fichiers marqués .ee., est soumis à la Sustainable Use License. Sa principale restriction est la suivante : « Vous pouvez utiliser ou modifier le logiciel uniquement pour vos propres besoins professionnels internes, ou à des fins non commerciales ou personnelles. » Apache-2.0 n’impose aucune restriction de ce type sur l’utilisation de Nod. Si vous déterminez ce que vous pouvez créer avec n8n, lisez l’explication de la Sustainable Use License de n8n avant de concevoir un produit basé dessus.

Ce dont le VPS a besoin pour exécuter Nod

La documentation d’auto-hébergement indique Docker Engine 25 ou une version ultérieure avec Compose v2, OpenSSL, ainsi que sha256sum ou shasum. Une compilation depuis les sources nécessite également Git. Les hôtes pris en charge sont Linux sur AMD64 ou ARM64, ou un Mac avec Docker Desktop.

Pour les ressources, la documentation indique : « Commencez avec 2 cœurs CPU, 8 GB de mémoire et 50 GB d’espace disque. » Il s’agit d’une base de départ recommandée, et non d’un minimum mesuré. La documentation précise également que les tâches simultanées dans le navigateur et les modèles locaux nécessitent davantage de ressources. Le fichier compose.yaml du kit explique l’essentiel de la quantité de mémoire indiquée. Il limite le conteneur du serveur à 2 GB, le navigateur à 3 GB et l’espace de travail à 2 GB. Vous pouvez modifier ces limites avec NOD_SERVER_MEMORY, NOD_BROWSER_MEMORY et NOD_WORKSPACE_MEMORY dans .env. Postgres et Caddy n’ont aucune limite.

Vous n’avez pas besoin d’une clé d’API de modèle pour installer l’application. Vous connectez un modèle dans l’application après son démarrage.

Installez d’abord Docker si le serveur ne l’a pas. Bases de Docker Compose sur un VPS explique la procédure. Vérifiez ensuite les versions et ajoutez les autres outils :

docker version
docker compose version
sudo apt update && sudo apt install -y git openssl

La section Server: de docker version doit afficher la version 25 ou une version ultérieure, et docker compose version doit réussir. Les commandes ci-dessous supposent que votre utilisateur peut exécuter docker sans sudo. Si ce n’est pas le cas, ajoutez sudo devant chaque commande docker et sh.

Cloner le dépôt Nod sur un tag précis

Le kit se trouve dans deployment/self-host/ et construit ses images Nod à partir de votre checkout. Rien de spécifique à Nod n’est récupéré depuis un registry. Le tag que vous checkout est donc la version que vous exécutez.

git clone https://github.com/n8n-io/nod.git
cd nod
git checkout nod-v0.8.1
cd deployment/self-host
ls

ls doit notamment contenir setup.sh, compose.yaml, Caddyfile, backup.sh et restore.sh. Les tags nod-v0.8.0 et nod-v0.8.1 ont tous deux été créés le 16 novembre 2026. Ce ne sont pas les plus récents. Au 21 novembre 2026, nod-v0.9.1, daté du 20 novembre, est marqué Latest. Ce guide a été vérifié avec le kit nod-v0.8.1. Il utilise donc ce tag. La section consacrée aux mises à jour ci-dessous explique comment passer à une version ultérieure.

Les images tierces de compose.yaml sont épinglées par digest, et non par :latest : postgres:17-alpine, node:24.21.0-bookworm-slim et caddy:2.11.7-alpine. Par défaut, les images Nod utilisent le tag local, via NOD_IMAGE_TAG. Définir cette variable ne télécharge pas une release publiée.

Générez les secrets avec setup.sh

sh setup.sh

setup.sh n’accepte aucun flag. Il copie .env.example vers un fichier privé .env et renseigne quatre valeurs générées : un nom de projet Compose, NOD_AUTH_TOKEN (à partir de openssl rand -hex 32), NOD_VAULT_KEY (à partir de openssl rand -base64 32) et NOD_POSTGRES_PASSWORD. Il exécute ensuite chmod 600 .env, afin que seul votre utilisateur puisse lire le fichier.

Le script termine en affichant Ready. Run: docker compose --file compose.yaml --env-file .env up -d --build --wait. Si .env existe déjà, il le conserve et affiche Using the existing .env. Its keys and data are unchanged.. Il refuse de s’exécuter si NOD_AUTH_TOKEN, NOD_VAULT_KEY ou NOD_POSTGRES_PASSWORD est déjà défini dans votre shell. Si vous avez exporté l’une de ces variables, commencez par les unset. Avec une version plus ancienne de Docker, il s’arrête avec Use Docker Engine 25 or newer..

Construire et démarrer la stack

docker compose up -d --build --wait
docker compose ps

La première construction est lente, car le kit construit les images Nod depuis les sources. Laissez le terminal ouvert jusqu’à la fin de la commande. --wait attend que les services dotés de health checks soient signalés comme sains avant de se terminer. Si la commande se termine sans erreur, la stack est donc démarrée. docker compose ps doit afficher server, postgres, browser et les autres services en cours d’exécution, avec server indiqué comme sain.

Si vous exécutez docker compose up avant setup.sh, Compose refuse de démarrer et affiche Run sh setup.sh first. Cela se produit parce que compose.yaml indique que NOD_AUTH_TOKEN est obligatoire, et que seul setup.sh l’écrit.

Pour consulter le journal du serveur :

docker compose logs --tail 100 server

La documentation précise que le token n’est jamais affiché dans les journaux de démarrage.

Le port 4310 reste lié à loopback, et ce n’est pas ufw qui le protège

Le serveur publie son port hôte comme suit dans compose.yaml :

'${NOD_BIND_ADDRESS:-127.0.0.1}:${PORT:-4310}:${PORT:-4310}'

Nod écoute donc sur le port 4310, et le côté hôte est lié à 127.0.0.1. Seuls les processus exécutés sur le serveur lui-même peuvent se connecter. Conservez cette configuration.

C’est plus important qu’il n’y paraît, car les ports publiés par Docker contournent ufw. La documentation Docker indique que le trafic vers un port de conteneur publié « est redirigé avant de passer par les règles du pare-feu ufw » et « ignore donc effectivement votre configuration de pare-feu ». Une règle ufw deny 4310 ne protégerait pas un port publié sur toutes les interfaces. C’est la liaison à loopback qui maintient le port 4310 privé. Pourquoi les ports Docker contournent ufw explique le mécanisme et indique comment vérifier votre propre serveur.

Docker comporte une restriction liée à la version. Avec les versions antérieures à 28.0.0, les hôtes situés sur le même segment réseau de couche 2 peuvent accéder aux ports publiés sur localhost. Sur un VPS, ce segment correspond au réseau de votre fournisseur. Utilisez donc Docker 28 ou une version ultérieure si possible.

Ne remplacez pas NOD_BIND_ADDRESS par 0.0.0.0 pour accéder à l’application à distance. La documentation indique : « N’exposez jamais PostgreSQL, le navigateur, l’espace de travail ni la connexion Docker. » Utilisez l’une des deux méthodes d’accès ci-dessous.

Ouvrir Nod via un tunnel SSH

Le tunnel ne nécessite ni domaine ni port ouvert en dehors de SSH. Exécutez cette commande sur votre propre ordinateur, pas sur le serveur :

ssh -L 4310:127.0.0.1:4310 user@203.0.113.10

Laissez cette session ouverte et accédez à http://localhost:4310 dans votre navigateur local. Pour cette configuration, laissez NOD_PUBLIC_URL sur sa valeur locale par défaut, http://localhost:4310. Si vous avez modifié PORT, modifiez les deux extrémités du tunnel ainsi que l’adresse du navigateur pour utiliser la même valeur.

L’application demande le jeton d’accès. Affichez-le sur le serveur :

grep NOD_AUTH_TOKEN .env

Collez la valeur située après = dans le formulaire d’accès, puis terminez la configuration initiale et connectez un modèle. Le jeton reste requis même via le tunnel.

Si vous accédez plutôt à vos serveurs avec Tailscale, lisez Tailscale Serve ou Funnel avant de placer quoi que ce soit devant Nod, car Funnel publie un service sur Internet public.

Ou servir Nod en HTTPS avec le profil Caddy

Pour une adresse publique, le kit fournit un profil https. Il ajoute un conteneur Caddy qui obtient et renouvelle le certificat TLS (transport layer security), puis transmet le trafic au serveur. Vous avez besoin d’un domaine dont l’enregistrement DNS pointe vers le VPS. Vous devez également autoriser les connexions TCP entrantes sur les ports 80 et 443 dans le pare-feu réseau de votre fournisseur, s’il en fournit un.

Modifiez .env et définissez l’origine exacte :

NOD_PUBLIC_URL=https://nod.example.com

NOD_PUBLIC_URL désigne « l’origine exacte avec laquelle vous ouvrez Nod ». Indiquez uniquement le schéma et l’hôte. Les chemins, chaînes de requête et fragments sont refusés. Le profil exige une origine https:// sur le port 443, avec un nom DNS ou une adresse IPv4. Démarrez ensuite la stack avec le profil :

docker compose --profile https up -d --build --wait

Ajoutez systématiquement --profile https aux commandes ultérieures de démarrage, d’arrêt et d’affichage de l’état. Sinon, Compose exclut le conteneur Caddy. Ouvrez https://nod.example.com et collez le token comme indiqué précédemment.

Vous devez savoir ce que cette configuration expose. Le service Caddy publie 80:80, 443:443 et 443:443/udp sans adresse de bind. Ces ports écoutent donc sur toutes les interfaces. Ils utilisent toujours les ports hôte 80 et 443, quelle que soit la valeur de PORT. En raison du contournement Docker décrit plus haut, ufw ne les fermera pas. Si vous utilisez déjà un reverse proxy, n’utilisez pas ce profil. Dirigez le proxy vers 127.0.0.1:4310 et définissez NOD_PUBLIC_URL sur l’origine HTTPS du proxy.

Vérifier l’activation des données d’utilisation et des retours

La documentation indique que « le partage des données d’utilisation est activé pour les nouveaux propriétaires ». Les données sont envoyées au projet PostHog hébergé dans l’UE par l’équipe Nod, y compris depuis les installations indépendantes. Le déploiement doit également l’autoriser, et NOD_ANALYTICS_ENABLED=false le désactive toujours.

Le kit situé dans nod-v0.8.1 fournit NOD_ANALYTICS_ENABLED=false dans .env.example, et setup.sh copie cette ligne dans votre .env. Ainsi, une nouvelle installation réalisée avec ce guide désactive par défaut l’analytics au niveau du serveur. Vérifiez-le :

grep -n NOD_ANALYTICS_ENABLED .env

Si la ligne est absente ou vide, le serveur considère que l’analytics est autorisé lorsqu’il s’exécute en mode production. Cela peut arriver avec un .env ancien ou créé manuellement. Dans ce cas, définissez vous-même la ligne sur false.

Le collecteur de retours est distinct. NOD_FEEDBACK_ENABLED ne se trouve pas dans .env.example, et la documentation indique qu’il est activé par défaut. Elle décrit une désactivation complète : définissez l’analytics et les retours sur false, et laissez NOD_ONBOARDING_EMAIL_URL vide.

echo 'NOD_FEEDBACK_ENABLED=false' >> .env
grep -n -e NOD_ANALYTICS_ENABLED -e NOD_FEEDBACK_ENABLED -e NOD_ONBOARDING_EMAIL_URL .env
docker compose up -d --wait server

La dernière commande recrée le serveur avec les nouvelles valeurs. Ajoutez --profile https si vous l’utilisez. Les propriétaires peuvent également modifier le partage dans l’application, sous Settings, Privacy & data, Share usage data. L’arrêt du partage ne supprime pas les données déjà envoyées.

Sauvegardez la clé Vault et les données : cette étape est obligatoire

NOD_VAULT_KEY est « une clé de 32 octets encodée en base64 qui chiffre les identifiants enregistrés ». Elle se trouve dans .env, en dehors de la base de données. La documentation de Vault précise que « les identifiants enregistrés ne peuvent pas être lus sans cette clé ». Nod ne génère jamais de clé de remplacement une fois que des données chiffrées existent. La page d’auto-hébergement indique que « la base de données seule ne permet pas de récupérer les identifiants enregistrés ». Si vous perdez la clé, tous les identifiants que vous avez fournis à Nod sont perdus, même avec un dump complet et intact de la base de données.

Enregistrez donc d’abord la clé séparément, dans un gestionnaire de mots de passe ou dans un autre emplacement sûr hors du serveur :

grep NOD_VAULT_KEY .env

Effectuez ensuite une sauvegarde complète avec le script fourni par le kit. La destination doit être un chemin absolu qui n’existe pas encore :

mkdir -p "$HOME/nod-backups"
chmod 700 "$HOME/nod-backups"
sh backup.sh "$HOME/nod-backups/nod-2026-11-21"

Le script arrête le serveur, le navigateur et l’espace de travail pendant la copie, puis les redémarre. Il affiche Backup saved: et le chemin. Le répertoire contient .env, source-commit, un postgres.dump, les archives des données du serveur, de l’espace de travail, des outils et du navigateur, ainsi qu’un fichier marqueur complete. Vérifiez la présence de ce marqueur avant de vous fier à la sauvegarde.

La documentation précise que « la sauvegarde contient des secrets ». Elle contient tous les secrets générés, y compris la clé Vault. Stockez-la sous forme chiffrée et limitez les personnes autorisées à la lire. Copiez-la hors du serveur, car une sauvegarde conservée sur le même disque est perdue avec celui-ci. Les certificats TLS ne sont pas inclus.

Restaurer Nod dans un nouveau checkout

La restauration s’effectue dans un nouveau dossier et un nouveau projet Compose. Identifiez le commit à partir duquel la sauvegarde a été créée, puis faites exactement le checkout de ce commit :

commit="$(cat "$HOME/nod-backups/nod-2026-11-21/source-commit")"
git clone https://github.com/n8n-io/nod.git nod-restored
cd nod-restored
git checkout "$commit"
cd deployment/self-host
sh restore.sh "$HOME/nod-backups/nod-2026-11-21" nod-restored

N’exécutez pas setup.sh en premier. restore.sh nécessite un checkout sans .env et un source-commit correspondant à la révision extraite. Il crée de nouveaux volumes, restaure la base de données et ne démarre pas l’application. Il se termine par Restored into a new project. Review .env before starting Nod.

Arrêtez le serveur d’origine avant de démarrer celui qui a été restauré. Exécutez ensuite docker compose up -d --build --wait, avec --profile https pour une adresse publique. N’exécutez jamais docker compose down --volumes sur un serveur que vous souhaitez conserver. Cette commande supprime les volumes de données.

Mettre Nod à jour vers un tag plus récent

Commencez par effectuer une sauvegarde. Ensuite, depuis nod/deployment/self-host :

docker compose stop
git fetch origin --tags
git checkout nod-v0.9.1
docker compose up -d --build --wait

Les migrations de base de données sont exécutées au démarrage de Nod. Vous ne pouvez donc pas annuler une mise à jour en revenant à l’ancien tag. La documentation indique : « Ne pointez pas une version plus ancienne de l’application vers une base de données déjà mise à jour. » Pour effectuer un rollback, restaurez la sauvegarde précédant la mise à jour dans un nouveau checkout. Consultez les notes de version avant chaque mise à niveau, car le libellé preview indique que des changements incompatibles sont attendus. Ne modifiez pas COMPOSE_PROJECT_NAME pendant une mise à jour.

Pour renouveler le token d’accès, exécutez openssl rand -hex 32, remplacez la valeur NOD_AUTH_TOKEN dans .env, puis exécutez docker compose up -d --wait server. L’ancien token cesse alors de fonctionner. Ne remplacez jamais NOD_VAULT_KEY pour renouveler l’accès.

FAQ

Ai-je besoin de n8n pour exécuter Nod ?

Non. Le README indique que Nod est sa propre application, développée par l’équipe à l’origine de n8n, et qu’il ne s’agit pas de n8n AI Assistant. Nod s’exécute dans sa propre stack Docker Compose. Vous pouvez connecter une instance n8n ultérieurement et demander à Nod de l’utiliser par son nom, mais l’installation ne dépend pas de n8n.

Nod est-il open source sous la même licence que n8n ?

Non. Nod est distribué sous la licence Apache 2.0, avec n8n GmbH comme titulaire des droits d’auteur. Les assets tiers inclus conservent leurs propres conditions. Le code de n8n situé en dehors de ses fichiers .ee. est couvert par la Sustainable Use License, qui limite l’utilisation aux besoins internes d’une entreprise, aux usages non commerciaux ou aux usages personnels. Apache-2.0 n’impose aucune limite de ce type.

Comment ouvrir Nod sur un VPS sans nom de domaine ?

Utilisez un tunnel SSH depuis votre propre ordinateur : ssh -L 4310:127.0.0.1:4310 user@203.0.113.10. Laissez-le ouvert, accédez à http://localhost:4310, puis collez NOD_AUTH_TOKEN depuis le serveur dans .env. Laissez NOD_PUBLIC_URL avec sa valeur locale par défaut. Le port 4310 reste lié à l’interface loopback du serveur ; rien de nouveau n’est donc exposé.

Que se passe-t-il si je perds NOD_VAULT_KEY ?

Les identifiants enregistrés ne peuvent plus être lus. La clé les chiffre et est stockée dans .env, en dehors de la base de données. Nod ne génère pas de clé de remplacement une fois que des données chiffrées existent. Un dump de la base de données seul ne suffit donc pas. Conservez une copie de la clé en dehors du serveur. Exécutez également sh backup.sh avec un chemin absolu, car la sauvegarde contient .env avec la clé.

ufw protège-t-il les ports de Nod ?

Pas les ports publiés par Docker. Docker achemine le trafic vers les ports de conteneur publiés sans tenir compte des règles de ufw. Le port 4310 reste privé uniquement parce que compose.yaml le lie à 127.0.0.1. Le profil https publie 80, 443 et 443/udp sur toutes les interfaces ; ufw ne peut donc pas les fermer. Avec une version de Docker antérieure à 28.0.0, les hôtes situés sur le même segment de couche 2 peuvent également atteindre les ports publiés sur localhost.

Cet article vous a-t-il été utile ?