Saltar al contenido

n8n autohospedado skill

Despliega y mantiene n8n con Docker, HTTPS mediante Caddy, servicios privados y copias verificadas.

Comunidad · Romuald Członkowski
AutorRomuald Członkowski
LicenciaMIT
Fuenteczlonkowski/n8n-skills · SKILL.md en GitHub
Sitio del proyectodocs.n8n.io/deploy/host-n8n
Funciona enClaude Code · Codex, Gemini CLI, Cursor, Copilot
Leída en la fuente el

n8n-self-hosting guía al agente desde una máquina Linux nueva hasta una instancia n8n con HTTPS mediante Docker Compose y Caddy.

Distingue instancia única con SQLite y modo cola con Postgres, Redis y ejecutores externos emparejados. Es una skill de operaciones, no de creación de flujos.

Del SKILL.md de la skill: # Deploying self-hosted n8n

Esta es una skill de la comunidad creada por Romuald Członkowski, sin revisar por nosotros ni por Anthropic. Las skills pueden indicar al agente que ejecute código, lea archivos o acceda a la red. Antes de instalarla, lee su SKILL.md y cada script de la carpeta, y busca cualquier cosa que no encaje con lo que dice hacer.

Qué hace

  1. Recoge modo, dominio, SSH y zona horaria antes del despliegue.
  2. Genera secretos en el servidor y mantiene privados los servicios internos.
  3. Verifica salud, TLS y trabajadores; documenta copia y restauración.

Qué obtienes

  • Configuración Compose, Caddyfile y archivo de entorno privado.
  • Comprobaciones de despliegue y entrega de mantenimiento posterior.

Cuándo usarla

  • Desplegar n8n en un servidor Linux autorizado.
  • Reparar ejecutores Python o configuración de trabajadores de cola.

Cuándo no usarla

  • Crear flujos o administrar n8n Cloud.

Qué necesita

  • Máquina Linux, SSH con root o sudo, DNS del dominio y puertos públicos 80/443.
  • Docker Compose y Caddy; servidor, dominio y funciones de pago de n8n tienen costes aparte.

Archivos de la skill

Archivo o carpetaPara qué sirve
SKILL.mdSelección de modo y secuencia de despliegue.
TASK_RUNNERS.mdConfiguración de ejecutores externos Python y JavaScript.
DAY2.mdProcedimientos de actualización, copia y restauración.
assets/Plantillas Compose, Caddy y entorno para instancia única o cola.

Licencia según el repositorio el 2026-11-17: MIT.

Prompts de ejemplo

Escribe uno de estos después de instalarla; si nombras la skill, te aseguras de que se use.

  • Planifica una instancia única en mi máquina Linux; comprueba DNS y acceso antes de modificarla.
  • Revisa la paridad de entorno de trabajadores y los ejecutores externos emparejados en mi despliegue de cola.
  • Redacta una lista de copia y restauración que conserve la clave de cifrado de n8n.

Cómo instalar n8n-self-hosting

Acceso al servidor

La carpeta individual necesita SSH y operaciones de sistema. Aquí no se ha verificado el flujo completo mediante subida a Claude.ai ni API aislada.

El plugin n8n completo añade enrutamiento y hooks. Copia solo esta carpeta si quieres instrucciones de despliegue sin el conjunto.

Una skill es una carpeta con un archivo SKILL.md. La instalas una vez; el agente lee su breve descripción al empezar cada sesión y carga las instrucciones completas solo cuando una petición encaja. Elige dónde la usas:

Claude Code: copia la carpeta en tu carpeta de skills

Pon la carpeta de la skill en ~/.claude/skills/ para usarla en todos los proyectos de este ordenador, o en .claude/skills/ dentro de un repositorio para compartirla con todos los que trabajan en él (haz 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 detecta las skills nuevas o modificadas en estas carpetas durante la sesión. Si la carpeta de skills no existía al empezar la sesión, ejecuta /reload-skills una vez. Después escribe /n8n-self-hosting o simplemente describe la tarea.

En Windows, ejecuta los comandos en Git Bash o WSL, o copia la carpeta al mismo sitio con el Explorador de archivos.

Codex, Gemini CLI, Cursor y GitHub Copilot

Estos agentes leen las mismas carpetas SKILL.md. La única carpeta que aceptan los cuatro dentro de un proyecto es .agents/skills/, así que esto copia la skill ahí:

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/
AgenteCarpeta del proyectoTu carpeta de usuarioNotas
OpenAI Codex
.agents/skills/
~/.agents/skills/
Escribe $ o ejecuta /skills para elegir una skill; Codex también elige una cuando tu tarea encaja.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
O instálala desde Git con gemini skills install <git URL> --path <folder> --consent. El 18 de junio de 2026, Google sustituyó Gemini CLI por Antigravity CLI para los usuarios del nivel gratuito y de Google One; Antigravity usa .agents/skills/ en un proyecto y ~/.gemini/config/skills/ para ti.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Escribe / en el chat de Agent para elegir una skill. Cursor también lee las carpetas .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona en Copilot CLI, en el agente en la nube y en el modo agente de VS Code, Visual Studio y JetBrains (la compatibilidad con cada IDE depende de la versión). O ejecuta gh skill install OWNER/REPOSITORY SKILL (vista previa pública, GitHub CLI 2.90.0 o posterior).
Instala solo skills de confianza. Anthropic aconseja usar solo skills de fuentes de confianza y leer todos los archivos de cualquier otra skill antes de usarla: una skill puede indicar al agente que ejecute comandos, lea archivos o envíe datos de formas que su descripción no menciona.

Fuentes de estos pasos

Comprobado con la documentación de cada proveedor el 2026-11-14:

Límites operativos

Revisa objetivo, ventana de mantenimiento y copia antes de ejecutar comandos en una instancia existente. Las plantillas no prueban que el servidor esté sano.

n8n autohospedado tiene sus propias ediciones y licencias, separadas de esta skill MIT.

Preguntas sobre n8n-self-hosting

¿Necesita n8n-mcp?

El despliegue usa SSH y Docker. n8n-mcp pertenece al conjunto de creación de flujos y no es necesario para aprovisionar el servidor.

¿Qué modo debo elegir?

Elige expresamente instancia única o cola antes de desplegar. La cola requiere Postgres y Redis, no SQLite.

¿Puedo perder las credenciales guardadas?

Sí, si se pierde o cambia la clave de cifrado. Conserva una copia protegida fuera del servidor junto con los datos.

¿Basta una respuesta HTTP de salud?

No. También comprueba TLS público, disponibilidad y, cuando corresponda, paridad de trabajadores y ejecutores de tareas.

Más skills de IA

Skills relacionadas

Categorías de skills