Cómo instalar n8n en Ku­be­r­ne­tes paso a paso

Ku­be­r­ne­tes se utiliza para desplegar, gestionar y escalar apli­ca­cio­nes en co­n­te­ne­do­res, incluidas he­rra­mie­n­tas como n8n cuando es necesario. En esta guía apre­n­de­rás cómo instalar n8n en Ku­be­r­ne­tes para crear una base limpia, estable y fácil de ad­mi­ni­s­trar.

Paso 1: comprobar los re­qui­si­tos y elegir el servidor adecuado

Antes de instalar n8n en Ku­be­r­ne­tes, primero necesitas un servidor Linux, pre­fe­ri­ble­me­n­te con una dirección IP pública fija, un dominio o su­b­do­mi­nio propio y acceso root. Para esta guía, la opción más sencilla es utilizar un único servidor con Ubuntu como base e instalar después una di­s­tri­bu­ción ligera de Ku­be­r­ne­tes, como K3s. K3s es una buena opción para empezar, ya que incluye varios co­m­po­ne­n­tes ha­bi­tua­les de Ku­be­r­ne­tes.

También es im­po­r­ta­n­te elegir el tamaño del servidor de forma realista. Debes tener en cuenta que Ku­be­r­ne­tes añade sus propios co­m­po­ne­n­tes del sistema y que n8n también necesita memoria y CPU. A co­n­ti­nua­ción, reunimos algunos casos de uso ha­bi­tua­les y co­n­fi­gu­ra­cio­nes de servidor re­co­me­n­da­das.

Entorno de apre­n­di­za­je y pruebas para uso privado

Si primero quieres fa­mi­lia­ri­zar­te con n8n en Ku­be­r­ne­tes, una co­n­fi­gu­ra­ción de servidor básica suele ser su­fi­cie­n­te. En este caso, el objetivo principal es crear tus primeros flujos de trabajo o workflows de n8n, entender la interfaz y probar au­to­ma­ti­za­cio­nes sencillas. La carga no­r­ma­l­me­n­te será baja, ya que se ejecutan pocos flujos de trabajo al mismo tiempo y no hay un uso continuo en segundo plano. Para ello, suele bastar un servidor virtual privado (VPS) con 2 vCores, 2 GB de RAM y 80 GB NVMe. Ten en cuenta, sin embargo, que Ku­be­r­ne­tes también consume recursos, por lo que el re­n­di­mie­n­to será limitado. Por eso, esta opción solo resulta re­co­me­n­da­ble de forma puntual para workflows pro­du­c­ti­vos o eje­cu­cio­nes continuas.

Usuarios pa­r­ti­cu­la­res con uso pro­du­c­ti­vo o pequeñas startups

Si quieres utilizar n8n en Ku­be­r­ne­tes de forma activa en tu día a día, por ejemplo para au­to­ma­ti­zar procesos entre he­rra­mie­n­tas, API o proyectos propios, conviene pla­ni­fi­car algo más de capacidad. En este escenario, los workflows se ejecutan con re­gu­la­ri­dad o se activan mediante webhooks. Esta co­n­fi­gu­ra­ción también permite los primeros usos en equipo o pequeños proyectos co­la­bo­ra­ti­vos. Una co­n­fi­gu­ra­ción con 4 vCores, 4 GB de RAM y 120 GB NVMe ofrece un buen equi­li­brio entre re­n­di­mie­n­to y costes. Así di­s­po­n­drás de recursos su­fi­cie­n­tes para varias eje­cu­cio­nes si­mu­l­tá­neas de flujos de trabajo. Por eso, esta variante es una buena opción para empezar en un entorno pro­du­c­ti­vo.

Pymes con varios workflows y eje­cu­cio­nes pe­rió­di­cas

En pequeñas y medianas empresas, n8n suele uti­li­zar­se para la au­to­ma­ti­za­ción de procesos em­pre­sa­ria­les. Algunos ejemplos ha­bi­tua­les son la in­te­gra­ción de sistemas CRM, au­to­ma­ti­za­cio­nes de correo ele­c­tró­ni­co o el pro­ce­sa­mie­n­to de pedidos de una tienda online. En estos casos, los workflows se ejecutan con re­gu­la­ri­dad y, en parte, de forma si­mu­l­tá­nea, lo que aumenta no­ta­ble­me­n­te la carga del sistema. Una co­n­fi­gu­ra­ción con 6 vCores, 8 GB de RAM y 240 GB NVMe ofrece una base estable para el uso en pro­du­c­ción. Obtendrás eje­cu­cio­nes más rápidas y evitarás cuellos de botella cuando haya varios procesos al mismo tiempo. Además, tendrás margen su­fi­cie­n­te para ampliar la in­s­ta­la­ción más adelante.

Equipos en cre­ci­mie­n­to, agencias o entornos muy au­to­ma­ti­za­dos

Cuando se utiliza n8n de forma intensiva y se ejecutan muchos workflows al mismo tiempo, los re­qui­si­tos aumentan de forma co­n­si­de­ra­ble. En agencias o equipos más grandes, es habitual ejecutar numerosas au­to­ma­ti­za­cio­nes en paralelo para cubrir marketing, pro­ce­sa­mie­n­to de datos y procesos internos. También son fre­cue­n­tes los flujos de trabajo más complejos con varias llamadas a API o tiempos de ejecución más largos. Una co­n­fi­gu­ra­ción más potente con 8 vCores, 16 GB de RAM y 480 GB NVMe ayuda a mantener la es­ta­bi­li­dad del sistema y un buen re­n­di­mie­n­to. Esta variante ofrece margen su­fi­cie­n­te para crecer y absorber picos de carga elevados. Al mismo tiempo, crea una buena base para ampliar más adelante hacia co­n­fi­gu­ra­cio­nes de Ku­be­r­ne­tes más es­ca­la­bles.

Tabla resumen: se­r­vi­do­res y casos de uso

Para es­ce­na­rios es­pe­cia­l­me­n­te amplios, con muchas eje­cu­cio­nes si­mu­l­tá­neas o servicios adi­cio­na­les en el mismo servidor, también puede resultar útil una co­n­fi­gu­ra­ción superior con 12 vCores, 24 GB de RAM y 720 GB NVMe.

Paso 2: preparar el servidor e instalar los paquetes básicos

Conéctate por SSH a tu servidor Ubuntu y actualiza primero los re­po­si­to­rios de paquetes y el software instalado. Esto es im­po­r­ta­n­te para empezar con una base limpia y ac­tua­li­za­da.

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget nano openssl

A co­n­ti­nua­ción, puedes comprobar si el servidor es accesible co­rre­c­ta­me­n­te y si ya dispone de una IP pública:

hostname -I

También puedes verificar la IP pública en tu proveedor de hosting. Anota la dirección, ya que la ne­ce­si­ta­rás dentro de poco para crear el registro DNS de tu su­b­do­mi­nio.

Paso 3: hacer que el su­b­do­mi­nio apunte al servidor

Crea en tu proveedor de dominios un registro A para el su­b­do­mi­nio que quieras utilizar. Si más adelante tu instancia de n8n en Ku­be­r­ne­tes debe estar di­s­po­ni­ble en n8n.tu-dominio.es, ese su­b­do­mi­nio debe apuntar exac­ta­me­n­te a la IP pública de tu servidor. Solo cuando este registro DNS esté activo, el acceso externo y las co­ne­xio­nes HTTPS fu­n­cio­na­rán de forma fiable.

Un registro DNS típico tendría este aspecto:

Tipo: A
Nombre: n8n
Valor: 203.0.113.10
TTL: 3600

Paso 4: instalar K3s

Si estás empezando, K3s suele ser la forma más cómoda de desplegar Ku­be­r­ne­tes en un único servidor. K3s incluye por defecto varios co­m­po­ne­n­tes im­po­r­ta­n­tes como co­m­ple­me­n­tos, entre ellos Traefik como co­n­tro­la­dor de entrada y soporte integrado para al­ma­ce­na­mie­n­to pe­r­si­s­te­n­cia local.

Instala primero K3s con el siguiente comando:

curl -sfL https://get.k3s.io | sh -

Comprueba después con este comando si el servicio se está eje­cu­ta­n­do:

sudo systemctl status k3s

Si todo se ha iniciado co­rre­c­ta­me­n­te, puedes consultar el estado del clúster:

sudo k3s kubectl get nodes

Close

Para utilizar kubectl con más comodidad, lo mejor es crear un alias:

echo 'alias kubectl="sudo k3s kubectl"' >> ~/.bashrc
source ~/.bashrc
kubectl get nodes

Si aquí tu servidor aparece con el estado “Ready”, Ku­be­r­ne­tes está listo para usarse.

Paso 5: instalar Helm

El chart de Helm oficial de n8n requiere Helm 3.12 o una versión más reciente. Helm es un gestor de paquetes para Ku­be­r­ne­tes y cumple una función similar a apt en Ubuntu. En lugar de crear y gestionar ma­nua­l­me­n­te archivos de co­n­fi­gu­ra­ción in­di­vi­dua­les, con Helm puedes instalar apli­ca­cio­nes completas mediante “Charts”. Así, la in­s­ta­la­ción resulta mucho más sencilla, clara y menos propensa a errores.

Helm resulta muy útil si estás empezando, ya que no necesitas entender ni escribir cada archivo YAML por tu cuenta. En su lugar, solo ajustas algunos pa­rá­me­tros pri­n­ci­pa­les y Helm se encarga au­to­má­ti­ca­me­n­te del resto. Más adelante, también podrás aplicar ac­tua­li­za­cio­nes o cambios con mayor facilidad, porque Helm gestiona el estado de tu in­s­ta­la­ción.

Instala ahora Helm di­re­c­ta­me­n­te en tu servidor. La do­cu­me­n­ta­ción oficial de Helm explica la in­s­ta­la­ción mediante binarios pre­co­m­pi­la­dos. Sin embargo, en Ubuntu también es habitual in­s­ta­lar­lo con el script oficial pro­po­r­cio­na­do. Este método es es­pe­cia­l­me­n­te sencillo:

curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
chmod 700 get_helm.sh
./get_helm.sh

Con el primer comando descargas el script de in­s­ta­la­ción. Después, haces que el archivo sea eje­cu­ta­ble y lo inicias. El script instala Helm au­to­má­ti­ca­me­n­te en la versión adecuada para tu sistema.

Comprueba después si la in­s­ta­la­ción se ha realizado co­rre­c­ta­me­n­te mostrando la versión instalada:

helm version

Close

Si aquí aparece un número de versión, Helm está instalado co­rre­c­ta­me­n­te y ya puedes utilizar el chart de Helm de n8n en Ku­be­r­ne­tes.

Paso 6: crear un namespace para n8n

Para mantener los recursos de n8n cla­ra­me­n­te separados de otros objetos de Ku­be­r­ne­tes, crea ahora un namespace propio, es decir, un espacio de nombres separado dentro de Ku­be­r­ne­tes. Se trata de una práctica re­co­me­n­da­da en Ku­be­r­ne­tes.

kubectl create namespace n8n

Comprueba después si el namespace se ha creado co­rre­c­ta­me­n­te:

kubectl get namespaces

Close

Paso 7: instalar cert-manager para ce­r­ti­fi­ca­dos TLS

Para una in­s­ta­la­ción accesible pú­bli­ca­me­n­te, conviene exponer n8n en Ku­be­r­ne­tes di­re­c­ta­me­n­te mediante HTTPS. El propio n8n re­co­mie­n­da utilizar para TLS un proxy inverso o una capa HTTP/HTTPS previa. En Ku­be­r­ne­tes, Traefik asume ese papel en esta guía, mientras que cert-manager au­to­ma­ti­za la emisión y re­no­va­ción de los ce­r­ti­fi­ca­dos. cert-manager también puede in­s­ta­lar­se mediante un chart de Helm. Para ello, utiliza el siguiente comando:

helm install cert-manager oci://quay.io/jetstack/charts/cert-manager \
--namespace cert-manager \
--create-namespace \
--set crds.enabled=true

Después, comprueba los pods. Los pods son la unidad eje­cu­ta­ble más pequeña de Ku­be­r­ne­tes y contienen uno o varios co­n­te­ne­do­res que se ejecutan juntos en un nodo. Permiten que los co­n­te­ne­do­res incluidos funcionen de forma conjunta y compartan recursos como red y al­ma­ce­na­mie­n­to.

kubectl get pods -n cert-manager

Close

Espera hasta que todos los pods hayan alcanzado el estado “Running” o “Completed”.

Paso 8: crear un Clu­s­te­rI­s­suer de Let’s Encrypt

Para que cert-manager pueda generar ce­r­ti­fi­ca­dos para tu dominio de forma au­to­má­ti­ca más adelante, crea ahora un recurso llamado Clu­s­te­rI­s­suer para Let’s Encrypt. Un Clu­s­te­rI­s­suer es una co­n­fi­gu­ra­ción central de Ku­be­r­ne­tes que define de qué proveedor se obtienen los ce­r­ti­fi­ca­dos y cómo se verifica tu dominio. En este caso se utiliza Let’s Encrypt, una entidad ce­r­ti­fi­ca­do­ra gratuita.

Para quienes empiezan, la va­li­da­ción mediante HTTP-01 suele ser la opción más sencilla, ya que no requiere conexión con ninguna API de DNS. En su lugar, Let’s Encrypt comprueba si tu dominio es accesible mediante una solicitud HTTP al dominio co­n­fi­gu­ra­do. Si esta solicitud tiene éxito, el dominio se considera ve­ri­fi­ca­do y se emite el ce­r­ti­fi­ca­do.

Crea ahora un archivo llamado clusterissuer.yaml:

nano clusterissuer.yaml

En este archivo defines la siguiente co­n­fi­gu­ra­ción:

apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
    name: letsencrypt-prod
spec:
    acme:
        email: tu-correo@ejemplo.es
        server: https://acme-v02.api.letsencrypt.org/directory
        privateKeySecretRef:
            name: letsencrypt-prod
        solvers:
            - http01:
                    ingress:
                        ingressClassName: traefik

Sustituye la dirección de correo ele­c­tró­ni­co por la tuya. Let’s Encrypt la utiliza para avisarte de in­fo­r­ma­ción im­po­r­ta­n­te, como la próxima caducidad de los ce­r­ti­fi­ca­dos.

Aplica después el archivo a tu clúster de Ku­be­r­ne­tes:

kubectl apply -f clusterissuer.yaml

Con ello se crea el Clu­s­te­rI­s­suer y queda di­s­po­ni­ble para todas las apli­ca­cio­nes del clúster. Después, comprueba que el recurso se haya creado co­rre­c­ta­me­n­te:

kubectl get clusterissuer

Close

Si aparece el Clu­s­te­rI­s­suer, la co­n­fi­gu­ra­ción se ha realizado co­rre­c­ta­me­n­te. La emisión del ce­r­ti­fi­ca­do se llevará a cabo más adelante de forma au­to­má­ti­ca, cuando n8n sea accesible mediante el dominio y se haya co­n­fi­gu­ra­do el recurso Ingress co­rre­s­po­n­die­n­te.

Paso 9: crear un secreto de Ku­be­r­ne­tes para n8n

El chart de Helm oficial utiliza un secreto de Ku­be­r­ne­tes para almacenar valores clave, entre ellos N8N_ENCRYPTION_KEY, N8N_HOST, N8N_PORT y N8N_PROTOCOL. Estos pa­rá­me­tros son ne­ce­sa­rios para el fu­n­cio­na­mie­n­to básico de n8n. Sustituye n8n.tu-dominio.es por tu su­b­do­mi­nio real y ejecuta después el siguiente comando:

kubectl create secret generic n8n-secrets -n n8n \
--from-literal=N8N_ENCRYPTION_KEY=$(openssl rand -hex 32) \
--from-literal=N8N_HOST=n8n.tu-dominio.es \
--from-literal=N8N_PORT=5678 \
--from-literal=N8N_PROTOCOL=https \
--from-literal=WEBHOOK_URL=https://n8n.tu-dominio.es/ \
--from-literal=N8N_PROXY_HOPS=1

Paso 10: crear el archivo values para la in­s­ta­la­ción de n8n

In­s­ta­la­mos n8n en el llamado modo Sta­n­da­lo­ne. Esto significa que n8n se ejecuta con una co­n­fi­gu­ra­ción sencilla: funciona en un único pod y no necesita servicios adi­cio­na­les como una base de datos externa o Redis. En su lugar, utiliza una base de datos SQLite integrada. Esta variante es ideal para primeros proyectos, in­s­ta­la­cio­nes pequeñas o para aprender, ya que resulta mucho menos compleja.

Para que Helm sepa cómo debe co­n­fi­gu­rar­se n8n, crea ahora un archivo de co­n­fi­gu­ra­ción llamado n8n-values.yaml.

nano n8n-values.yaml

En este archivo defines los ajustes más im­po­r­ta­n­tes para tu in­s­ta­la­ción, por ejemplo variables de entorno, espacio de al­ma­ce­na­mie­n­to o el dominio.

queueMode:
    enabled: false
database:
    type: sqlite
    useExternal: false
redis:
    enabled: false
persistence:
    enabled: true
    size: 10Gi
secretRefs:
    existingSecret: n8n-secrets
main:
    extraEnv:
        - name: TZ
            value: Europe/Madrid
ingress:
    enabled: true
    className: traefik
    annotations:
        cert-manager.io/cluster-issuer: letsencrypt-prod
    hosts:
        - host: n8n.tu-dominio.es
            paths:
                - path: /
                    pathType: Prefix
    tls:
        - secretName: n8n-tls
            hosts:
                - n8n.tu-dominio.es

Asegúrate de sustituir n8n.tu-dominio.es por tu propio dominio. Este archivo actúa como archivo principal de co­n­fi­gu­ra­ción de tu in­s­ta­la­ción y podrás ajustarlo más adelante en cualquier momento si quieres ampliar o escalar n8n.

Paso 11: instalar n8n con el chart oficial de Helm

Ahora sigue la in­s­ta­la­ción pro­pia­me­n­te dicha de n8n en Ku­be­r­ne­tes mediante el chart de Helm. Para ello, ejecuta el siguiente comando:

helm install n8n oci://ghcr.io/n8n-io/n8n-helm-chart/n8n \
--version 1.0.0 \
-n n8n \
-f n8n-values.yaml

Después, comprueba si se han creado los recursos:

kubectl get all -n n8n

A co­n­ti­nua­ción, revisa los pods con más detalle para ase­gu­rar­te de que n8n se ha iniciado co­rre­c­ta­me­n­te y no se han producido errores.

kubectl get pods -n n8n -w

En cuanto el pod principal esté en ejecución y listo, n8n quedará instalado en el clúster.

Paso 12: comprobar el Ingress y el ce­r­ti­fi­ca­do

Como ya has co­n­fi­gu­ra­do Ingress y TLS en el archivo values, cert-manager debería solicitar ahora un ce­r­ti­fi­ca­do para tu su­b­do­mi­nio. Primero, comprueba el Ingress:

kubectl get ingress -n n8n

A co­n­ti­nua­ción, comprueba el ce­r­ti­fi­ca­do:

kubectl get certificate -n n8n
kubectl describe certificate n8n-tls -n n8n

Paso 13: abrir n8n en el navegador y completar la co­n­fi­gu­ra­ción inicial

En cuanto el Ingress esté activo y el ce­r­ti­fi­ca­do se haya creado co­rre­c­ta­me­n­te, abre tu instancia en el navegador:

https://n8n.tu-dominio.es

La primera vez que accedas, n8n te guiará durante la co­n­fi­gu­ra­ción inicial. No­r­ma­l­me­n­te, en este paso crearás primero el usuario ad­mi­ni­s­tra­dor de la instancia.

Close

Paso 14: probar la in­s­ta­la­ción

Después de la co­n­fi­gu­ra­ción inicial, conviene comprobar bre­ve­me­n­te si la in­s­ta­la­ción funciona co­rre­c­ta­me­n­te. Para ello, abre el editor de n8n, crea un workflow de prueba sencillo y guárdalo. Además, también es re­co­me­n­da­ble revisar los registros (logs) del pod principal.

kubectl logs -n n8n -l app.kubernetes.io/component=main --tail=100

Si el editor es accesible, el inicio de sesión funciona y en los logs no aparecen errores evidentes, la in­s­ta­la­ción básica se ha co­m­ple­ta­do co­rre­c­ta­me­n­te.

Paso 15: lo que debes saber para el fu­n­cio­na­mie­n­to en pro­du­c­ción

Para in­s­ta­la­cio­nes pequeñas, el modo Sta­n­da­lo­ne es un buen punto de partida. Sin embargo, el chart oficial y la do­cu­me­n­ta­ción de n8n di­fe­re­n­cian cla­ra­me­n­te entre Sta­n­da­lo­ne y Queue Mode, un modo de ejecución con cola de tareas pensado para cargas mayores. En cuanto entran en juego varios usuarios, más eje­cu­cio­nes si­mu­l­tá­neas o una alta carga de webhooks, este modo suele ser la opción más sólida. En ese caso, se añaden Po­s­t­gre­S­QL y Redis. Además, los workers pueden escalarse de forma in­de­pe­n­die­n­te.