Aller au contenu

n8n auto-hébergé skill

Déployez et maintenez n8n avec Docker, HTTPS Caddy, services privés et sauvegardes vérifiées.

Communauté · Romuald Członkowski
AuteurRomuald Członkowski
LicenceMIT
Sourceczlonkowski/n8n-skills · SKILL.md sur GitHub
Site du projetdocs.n8n.io/deploy/host-n8n
Fonctionne dansClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lu à la source le

n8n-self-hosting guide l’agent d’une machine Linux vierge à une instance n8n HTTPS avec Docker Compose et Caddy.

Il distingue instance unique SQLite et mode file avec Postgres, Redis et exécuteurs externes appariés. C’est une skill d’exploitation, pas de création de workflows.

Extrait du SKILL.md du skill : # Deploying self-hosted n8n

Ceci est un skill de la communauté créé par Romuald Członkowski, vérifié ni par nous ni par Anthropic. Un skill peut demander à l’agent d’exécuter du code, de lire des fichiers ou d’accéder au réseau. Avant de l’installer, lisez son SKILL.md et chaque script du dossier, et cherchez tout ce qui ne correspond pas à ce qu’il prétend faire.

Ce qu’il fait

  1. Recueillez mode, domaine, SSH et fuseau horaire avant provisionnement.
  2. Générez les secrets sur le serveur et gardez les services internes privés.
  3. Vérifiez santé, TLS et workers ; documentez sauvegarde et restauration.

Ce que vous obtenez

  • Configuration Compose, Caddyfile et fichier d’environnement privé.
  • Vérifications de déploiement et consignes de maintenance ultérieure.

Quand l’utiliser

  • Déployer n8n sur un serveur Linux autorisé.
  • Corriger la configuration des exécuteurs Python ou workers.

Quand ne pas l’utiliser

  • Créer des workflows ou administrer n8n Cloud.

Ce qu’il faut

  • Machine Linux, SSH root ou sudo, DNS du domaine et ports publics 80/443.
  • Docker Compose et Caddy ; serveur, domaine et fonctions payantes n8n coûtent séparément.

Fichiers du skill

Fichier ou dossierÀ quoi il sert
SKILL.mdChoix du mode et séquence de déploiement.
TASK_RUNNERS.mdConfiguration des exécuteurs externes Python et JavaScript.
DAY2.mdMise à jour, sauvegarde et restauration.
assets/Modèles Compose, Caddy et environnement pour instance unique et file.

Licence trouvée dans le dépôt le 2026-11-17 : MIT.

Exemples de prompts

Tapez l’un de ces prompts après l’installation ; nommer le skill garantit qu’il sera utilisé.

  • Planifiez une instance unique sur ma machine Linux ; vérifiez DNS et accès avant de modifier quoi que ce soit.
  • Vérifiez la parité d’environnement des workers et leurs exécuteurs externes appariés.
  • Rédigez une procédure de sauvegarde et restauration préservant la clé de chiffrement n8n.

Comment installer n8n-self-hosting

Accès au serveur

Le dossier individuel nécessite SSH et opérations système. Le flux complet par téléversement Claude.ai ou API isolée n’est pas vérifié ici.

Le plugin n8n complet ajoute routage et hooks. Copiez seulement ce dossier pour le guide de déploiement sans installer tout le pack.

Un skill est un dossier contenant un fichier SKILL.md. Vous l’installez une fois ; l’agent lit sa courte description au début de chaque session et ne charge les instructions complètes que si une demande correspond. Choisissez l’environnement que vous utilisez :

Claude Code : copier le dossier dans votre dossier de skills

Placez le dossier du skill dans ~/.claude/skills/ pour l’utiliser dans tous les projets de cet ordinateur, ou dans .claude/skills/ à l’intérieur d’un dépôt pour le partager avec toutes les personnes qui y travaillent (committez-le).

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-self-hosting ~/.claude/skills/

Claude Code détecte pendant la session les skills nouveaux ou modifiés dans ces dossiers. Si le dossier de skills n’existait pas au démarrage de la session, lancez /reload-skills une fois. Tapez ensuite /n8n-self-hosting ou décrivez simplement la tâche.

Sous Windows, lancez les commandes dans Git Bash ou WSL, ou copiez le dossier au même endroit avec l’Explorateur de fichiers.

Codex, Gemini CLI, Cursor et GitHub Copilot

Ces agents lisent les mêmes dossiers SKILL.md. Le seul dossier que les quatre acceptent dans un projet est .agents/skills/ ; cette commande y copie donc le skill :

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-self-hosting .agents/skills/
AgentDossier du projetVotre dossier utilisateurRemarques
OpenAI Codex
.agents/skills/
~/.agents/skills/
Tapez $ ou lancez /skills pour choisir un skill ; Codex en choisit aussi un quand votre tâche correspond.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou installez-le depuis Git avec gemini skills install <git URL> --path <folder> --consent. Le 18 juin 2026, Google a remplacé Gemini CLI par Antigravity CLI pour les utilisateurs de l’offre gratuite et de Google One ; Antigravity utilise .agents/skills/ dans un projet et ~/.gemini/config/skills/ pour vous.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Tapez / dans le chat Agent pour choisir un skill. Cursor lit aussi les dossiers .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Fonctionne dans Copilot CLI, l’agent cloud et le mode agent de VS Code, Visual Studio et JetBrains (la prise en charge dans l’IDE dépend de la version). Ou lancez gh skill install OWNER/REPOSITORY SKILL (préversion publique, GitHub CLI 2.90.0 ou ultérieure).
N’installez que des skills de confiance. Anthropic conseille de n’utiliser que des skills provenant de sources de confiance, et de lire chaque fichier de tout autre skill avant de l’utiliser : un skill peut amener l’agent à exécuter des commandes, lire des fichiers ou envoyer des données d’une manière que sa description ne mentionne pas.

Sources de ces étapes

Vérifiées dans la documentation de chaque éditeur le 2026-11-14 :

Limites d’exploitation

Vérifiez cible, créneau de maintenance et sauvegarde avant toute commande sur une instance existante. Les modèles ne prouvent pas la santé du serveur.

n8n auto-hébergé possède ses éditions et licences, distinctes de cette skill MIT.

Questions sur n8n-self-hosting

Faut-il n8n-mcp ?

Le déploiement utilise SSH et Docker. n8n-mcp appartient au pack de création de workflows et n’est pas requis pour provisionner le serveur.

Quel mode choisir ?

Choisissez explicitement instance unique ou file avant de déployer. Le mode file nécessite Postgres et Redis, pas SQLite.

Puis-je perdre les identifiants enregistrés ?

Oui si la clé de chiffrement est perdue ou modifiée. Gardez une copie protégée hors du serveur avec les données sauvegardées.

Une réponse HTTP de santé suffit-elle ?

Non. La skill vérifie aussi TLS public, disponibilité et, si nécessaire, parité des workers et exécuteurs.

Plus de skills IA

Skills similaires

Catégories de skills