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| Auteur | Romuald Członkowski |
|---|---|
| Licence | MIT |
| Source | czlonkowski/n8n-skills · SKILL.md sur GitHub |
| Site du projet | docs.n8n.io/deploy/host-n8n |
| Fonctionne dans | Claude 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
Ce qu’il fait
- Recueillez mode, domaine, SSH et fuseau horaire avant provisionnement.
- Générez les secrets sur le serveur et gardez les services internes privés.
- 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.md | Choix du mode et séquence de déploiement. |
TASK_RUNNERS.md | Configuration des exécuteurs externes Python et JavaScript. |
DAY2.md | Mise à 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/| Agent | Dossier du projet | Votre dossier utilisateur | Remarques |
|---|---|---|---|
| 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). |
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
n8n Multi Instance skill
Communauté · Romuald CzłonkowskiCiblez explicitement plusieurs instances n8n et résolvez les ambiguïtés MCP.n8n Agents skill
Communauté · Romuald CzłonkowskiConcevez des agents n8n avec outils, mémoire, sortie structurée et validation humaine.n8n Code JavaScript skill
Communauté · Romuald CzłonkowskiÉcrivez ou déboguez JavaScript dans n8n selon les modes d’entrée et de retour.n8n Code Python skill
Communauté · Romuald CzłonkowskiÉcrivez du Python natif pour n8n 2.x avec limites explicites de sandbox et de mode.n8n Code Tool skill
Communauté · Romuald CzłonkowskiÉcrivez des Custom Code Tools n8n appelables par agent, avec query et sortie chaîne.n8n Node Configuration skill
Communauté · Romuald CzłonkowskiConfigurez les nœuds n8n selon leurs schémas actuels, opérations et dépendances.