Self-hosting n8n skill
Distribuisci e mantieni n8n con Docker, HTTPS Caddy, servizi privati e backup verificati.
Community · Romuald Członkowski| Autore | Romuald Członkowski |
|---|---|
| Licenza | MIT |
| Fonte | czlonkowski/n8n-skills · SKILL.md su GitHub |
| Sito del progetto | docs.n8n.io/deploy/host-n8n |
| Funziona in | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Letta dalla fonte il |
n8n-self-hosting guida l’agente da una nuova VM Linux a un’istanza n8n HTTPS con Docker Compose e Caddy.
Distingue istanza singola SQLite e modalità coda con Postgres, Redis ed esecutori esterni abbinati. È una skill operativa, non un creatore di workflow.
Dallo SKILL.md della skill: # Deploying self-hosted n8n
Cosa fa
- Raccogli modalità, dominio, SSH e fuso orario prima del provisioning.
- Genera segreti sul server e mantieni privati i servizi interni.
- Verifica integrità, TLS e worker; documenta backup e ripristino.
Cosa ottieni
- Configurazione Compose, Caddyfile e file di ambiente privato.
- Verifiche di distribuzione e consegna delle procedure di manutenzione.
Quando usarla
- Distribuire n8n su un server Linux autorizzato.
- Correggere configurazioni di esecutori Python o worker di coda.
Quando non usarla
- Creare workflow o amministrare n8n Cloud.
Cosa richiede
- VM Linux, SSH root o sudo, DNS del dominio e porte pubbliche 80/443.
- Docker Compose e Caddy; hosting, domini e funzioni n8n a pagamento hanno costi separati.
File della skill
| File o cartella | A cosa serve |
|---|---|
SKILL.md | Scelta modalità e sequenza di distribuzione. |
TASK_RUNNERS.md | Configurazione esecutori esterni Python e JavaScript. |
DAY2.md | Procedure di aggiornamento, backup e ripristino. |
assets/ | Modelli Compose singolo e coda, Caddy e ambiente. |
Licenza trovata nel repository il 2026-11-17: MIT.
Prompt di esempio
Scrivine uno dopo l'installazione; nominare la skill fa sì che venga usata.
- Pianifica un’istanza singola sulla mia VM Linux; controlla DNS e accesso prima di modificarla.
- Rivedi la distribuzione in coda per parità degli ambienti worker ed esecutori esterni abbinati.
- Scrivi una lista di backup e ripristino che conservi la chiave di cifratura n8n.
Come installare n8n-self-hosting
Accesso al server
La cartella individuale richiede SSH e operazioni di sistema. Caricamento Claude.ai e percorso API in sandbox non sono verificati per questo workflow.
Il plugin n8n completo aggiunge routing e hook. Copia solo questa cartella per la guida operativa senza installare l’intero pacchetto.
Una skill è una cartella con un file SKILL.md. La installi una volta sola; l'agente legge la sua breve descrizione all'inizio di ogni sessione e carica le istruzioni complete solo quando una richiesta corrisponde. Scegli dove la usi:
Claude Code: copia la cartella nella tua cartella delle skill
Metti la cartella della skill in ~/.claude/skills/ per usarla in tutti i progetti su questo computer, oppure in .claude/skills/ dentro un repository per condividerla con chiunque ci lavori (fanne il commit).
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 rileva le skill nuove o modificate in queste cartelle durante la sessione. Se la cartella delle skill non esisteva quando è iniziata la sessione, esegui una volta /reload-skills. Poi digita /n8n-self-hosting o descrivi semplicemente il compito.
Su Windows, esegui i comandi in Git Bash o WSL, oppure copia la cartella nello stesso percorso con Esplora file.
Codex, Gemini CLI, Cursor e GitHub Copilot
Questi agenti leggono le stesse cartelle SKILL.md. L'unica cartella di progetto accettata da tutti e quattro è .agents/skills/, quindi questo comando ci copia la 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/| Agente | Cartella del progetto | La tua cartella utente | Note |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Digita $ o esegui /skills per scegliere una skill; Codex ne sceglie una anche da solo quando il tuo compito corrisponde. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Oppure installa da Git con gemini skills install <git URL> --path <folder> --consent. Il 18 giugno 2026 Google ha sostituito Gemini CLI con Antigravity CLI per gli utenti del piano gratuito e di Google One; Antigravity usa .agents/skills/ in un progetto e ~/.gemini/config/skills/ per te. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Digita / nella chat Agent per scegliere una skill. Cursor legge anche le cartelle .claude/skills/ di Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funziona in Copilot CLI, nel cloud agent e nella modalità agente di VS Code, Visual Studio e JetBrains (il supporto negli IDE dipende dalla versione). Oppure esegui gh skill install OWNER/REPOSITORY SKILL (anteprima pubblica, GitHub CLI 2.90.0 o successiva). |
Fonti per questi passaggi
Verificati sulla documentazione di ciascun fornitore il 2026-11-14:
Limiti operativi
Rivedi destinazione, finestra di manutenzione e backup prima di eseguire comandi su istanze esistenti. I modelli sono punti di partenza, non prove di integrità del server.
n8n auto-ospitato ha edizioni e licenze proprie, separate da questa skill con licenza MIT.
Domande su n8n-self-hosting
Richiede n8n-mcp?
La distribuzione usa SSH e Docker. n8n-mcp appartiene al pacchetto più ampio per workflow e non serve al provisioning dei server.
Quale modalità scegliere?
Scegli esplicitamente singola o coda prima della distribuzione. La coda richiede Postgres e Redis, non SQLite.
Posso perdere le credenziali salvate?
Sì, se la chiave di cifratura viene persa o cambiata. Conserva una copia protetta fuori dal server insieme ai backup dei dati.
Una risposta HTTP di integrità è sufficiente?
No. La skill verifica anche TLS pubblico, disponibilità e, se applicabile, parità dei worker ed esecutori di attività.
Altre skill IA
Skill correlate
n8n Multi Instance skill
Community · Romuald CzłonkowskiSeleziona istanze n8n esplicitamente e risolvi routing MCP ambigui.n8n Agents skill
Community · Romuald CzłonkowskiProgetta agenti n8n con strumenti, memoria, output strutturato e revisione umana.n8n Code JavaScript skill
Community · Romuald CzłonkowskiScrivi o correggi JavaScript n8n con accesso e restituzioni adatti alla modalità.n8n Code Python skill
Community · Romuald CzłonkowskiScrivi Python nativo per n8n 2.x con limiti espliciti di sandbox e modalità.n8n Code Tool skill
Community · Romuald CzłonkowskiScrivi Custom Code Tool n8n per agenti con query e uscita stringa.n8n Node Configuration skill
Community · Romuald CzłonkowskiConfigura i nodi n8n secondo schemi attuali, operazioni e dipendenze.