Cómo instalar n8n con CasaOS paso a paso

n8n es una he­rra­mie­n­ta para au­to­ma­ti­zar flujos de trabajo con la que puedes conectar di­fe­re­n­tes apli­ca­cio­nes y servicios. En co­m­bi­na­ción con CasaOS, puedes instalar y gestionar n8n de forma es­pe­cia­l­me­n­te sencilla mediante una interfaz gráfica. En esta guía te mostramos paso a paso cómo instalar n8n con CasaOS.

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

Antes de comenzar con la in­s­ta­la­ción, necesitas un entorno adecuado en el que puedan eje­cu­tar­se CasaOS y n8n. Bá­si­ca­me­n­te, se deben cumplir los si­guie­n­tes re­qui­si­tos:

• Servidor Linux (re­co­me­n­da­do: Ubuntu 22.04 o 24.04)
• Acceso root o permisos sudo
• Conexión a Internet estable
• Opcional: un dominio para el acceso externo posterior

Dado que n8n necesita di­fe­re­n­tes recursos según el uso, conviene elegir el servidor en co­n­se­cue­n­cia. Los si­guie­n­tes casos de uso te ayudan a encontrar el punto de partida adecuado.

Caso de uso 1: usuarios pa­r­ti­cu­la­res o pequeñas au­to­ma­ti­za­cio­nes

Si quieres utilizar n8n para proyectos pe­r­so­na­les, por ejemplo, para au­to­ma­ti­zar correos ele­c­tró­ni­cos, redes sociales o pequeños procesos de datos, un servidor pequeño suele ser más que su­fi­cie­n­te. Los flujos de trabajo de n8n ha­bi­tua­les en este caso suelen ser bastante simples y no se ejecutan co­n­s­ta­n­te­me­n­te ni con mucha fre­cue­n­cia. Por ejemplo, puedes au­to­ma­ti­zar fuentes RSS, conectar API sencillas o crear no­ti­fi­ca­cio­nes. La carga es baja, por lo que basta con un servidor económico de nivel básico. En este caso, lo im­po­r­ta­n­te es disponer de su­fi­cie­n­te RAM para que n8n funcione de forma estable. La potencia de la CPU desempeña aquí un papel se­cu­n­da­rio.

Caso de uso 2: startups y proyectos en cre­ci­mie­n­to

Para startups o proyectos paralelos con un uso creciente, conviene pla­ni­fi­car algo más de re­n­di­mie­n­to. En cuanto se ejecutan varios flujos de trabajo al mismo tiempo o se utilizan API externas de forma más intensiva, la carga del sistema aumenta. Algunos es­ce­na­rios típicos son el pro­ce­sa­mie­n­to au­to­ma­ti­za­do de leads, la si­n­cro­ni­za­ción con el CRM o el uso de he­rra­mie­n­tas internas sencillas. En estos casos, ya se nota la ventaja de contar con más núcleos de CPU y memoria RAM adicional. Sobre todo si planeas usar n8n con re­gu­la­ri­dad o ampliarlo más adelante, es re­co­me­n­da­ble optar desde el principio por un servidor algo más potente.

Caso de uso 3: pymes y uso en pro­du­c­ción

En las pequeñas y medianas empresas, n8n se utiliza a menudo para procesos críticos para el negocio. Entre ellos se incluyen flujos de datos au­to­ma­ti­za­dos, in­te­gra­cio­nes entre sistemas o flujos de trabajo internos. En este caso, la es­ta­bi­li­dad es decisiva. Más RAM ayuda a que varios procesos se ejecuten en paralelo sin problemas de re­n­di­mie­n­to. Además, conviene disponer de su­fi­cie­n­te espacio de al­ma­ce­na­mie­n­to, es­pe­cia­l­me­n­te cuando se procesan logs, datos o archivos.

Caso de uso 4: apli­ca­cio­nes es­ca­la­bles y alta carga

Si utilizas n8n de forma intensiva, por ejemplo, para procesos basados en datos, muchos flujos de trabajo en paralelo o in­te­gra­cio­nes de mayor tamaño, conviene optar por sistemas de alto re­n­di­mie­n­to. En estos es­ce­na­rios suelen eje­cu­tar­se muchos procesos al mismo tiempo, en parte de forma co­n­ti­nua­da. Una CPU potente y una cantidad elevada de RAM son ese­n­cia­les, sobre todo porque pueden pro­du­ci­r­se picos te­m­po­ra­les de carga. El al­ma­ce­na­mie­n­to también debe di­me­n­sio­nar­se con margen para acompañar el cre­ci­mie­n­to y los volúmenes de datos a largo plazo.

Tabla resumen: re­co­me­n­da­cio­nes de servidor

Paso 2: instalar CasaOS

Antes de empezar con la in­s­ta­la­ción de n8n, primero necesitas CasaOS como interfaz de ad­mi­ni­s­tra­ción. CasaOS es una pla­ta­fo­r­ma fácil de usar con la que puedes instalar y gestionar apli­ca­cio­nes como n8n con unos pocos clics, sin tener que pro­fu­n­di­zar en Docker ni en comandos complejos de servidor.

Primero tienes que co­ne­c­tar­te a tu servidor. Esto suele hacerse mediante SSH. Para ello, abre una terminal e introduce el siguiente comando:

ssh root@TU-IP-DEL-SERVIDOR

Sustituye TU-IP-DEL-SERVIDOR por la dirección IP real de tu servidor. Después, confirma la conexión e introduce tu co­n­tra­se­ña.

En cuanto estés conectado a tu servidor, puedes instalar CasaOS con un solo comando:

curl -fsSL https://get.casaos.io | sudo bash

Este comando descarga el script de in­s­ta­la­ción oficial y lo ejecuta au­to­má­ti­ca­me­n­te. De este modo, se instalan y co­n­fi­gu­ran todos los co­m­po­ne­n­tes ne­ce­sa­rios. La in­s­ta­la­ción se realiza de forma co­m­ple­ta­me­n­te au­to­má­ti­ca y no­r­ma­l­me­n­te solo tarda unos minutos.

Close

Después de completar la in­s­ta­la­ción, puedes abrir CasaOS di­re­c­ta­me­n­te en el navegador. Para ello, introduce en la barra de di­re­c­cio­nes:

http://TU-IP-DEL-SERVIDOR

Paso 3: iniciar sesión en CasaOS y entender la interfaz

Después de acceder a la IP de tu servidor en el navegador, se carga la interfaz de usuario de CasaOS. En el primer inicio, se te guía au­to­má­ti­ca­me­n­te por la co­n­fi­gu­ra­ción inicial. Crea un usuario y una co­n­tra­se­ña segura y, a co­n­ti­nua­ción, inicia sesión. Después, llegarás di­re­c­ta­me­n­te al panel de control central de CasaOS. La interfaz es sencilla y clara, por lo que podrás orie­n­tar­te rá­pi­da­me­n­te incluso sin tener co­no­ci­mie­n­tos previos.

Las áreas más im­po­r­ta­n­tes son:

• App Store: aquí puedes instalar nuevas apli­ca­cio­nes como n8n con unos pocos clics.
• Installed Apps: en esta sección puedes ver todas las apli­ca­cio­nes ya in­s­ta­la­das y en ejecución.
• System overview: aquí se muestra la carga actual de tu servidor, por ejemplo, CPU, memoria RAM y espacio de al­ma­ce­na­mie­n­to.

De este modo, tienes una visión rápida de tu sistema y puedes gestionar las apli­ca­cio­nes de forma ce­n­tra­li­za­da.

Close

Paso 4: instalar n8n con CasaOS desde la App Store

Después de iniciar sesión en CasaOS, puedes instalar n8n di­re­c­ta­me­n­te desde la interfaz gráfica. Para ello, abre primero la App Store, que en­co­n­tra­rás en el panel de control de CasaOS. Por lo general, esta sección suele aparecer de forma destacada en la página de inicio. A co­n­ti­nua­ción, introduce el término “n8n” en la barra de búsqueda. En cuanto la apli­ca­ción aparezca en los re­su­l­ta­dos, haz clic en ella.

Close

En el siguiente paso verás una vista detallada de la apli­ca­ción. Haz clic en el botón «Instalar» para iniciar la in­s­ta­la­ción.

Close

CasaOS se encarga de la in­s­ta­la­ción de n8n con Docker y gestiona au­to­má­ti­ca­me­n­te la descarga de la imagen de Docker, la co­n­fi­gu­ra­ción del co­n­te­ne­dor y los ajustes básicos. Al cabo de poco tiempo, n8n estará instalado y aparecerá en la vista general de tus apli­ca­cio­nes in­s­ta­la­das. A co­n­ti­nua­ción, puedes iniciar y abrir la apli­ca­ción di­re­c­ta­me­n­te.

Al­te­r­na­ti­va: in­s­ta­la­ción manual con Docker (Custom App)

Si n8n no está di­s­po­ni­ble en la App Store o si quieres tener más control sobre la co­n­fi­gu­ra­ción, también puedes añadir la apli­ca­ción ma­nua­l­me­n­te como Custom App. Para ello, abre la App Store y haz clic en “Custom Install” o “+ Add App” según la versión de CasaOS. Luego, elige la opción para añadir una apli­ca­ción mediante una co­n­fi­gu­ra­ción de Docker Compose o YAML. Se abrirá un fo­r­mu­la­rio en el que puedes in­tro­du­cir tu co­n­fi­gu­ra­ción. Inserta allí el siguiente código:

services:
    n8n:
        image: docker.n8n.io/n8nio/n8n
        restart: unless-stopped
        ports:
            - "5678:5678"
        environment:
            - N8N_HOST=n8n.tudominio.es
            - N8N_PORT=5678
            - N8N_PROTOCOL=http
        volumes:
            - n8n_data:/home/node/.n8n
volumes:
    n8n_data:

Esta co­n­fi­gu­ra­ción hace que n8n se inicie como co­n­te­ne­dor, que el puerto estándar 5678 sea accesible desde el exterior y que los datos se almacenen de forma pe­r­ma­ne­n­te mediante un volumen. Después de insertar el código, confirma la entrada e inicia la in­s­ta­la­ción.

CasaOS crea au­to­má­ti­ca­me­n­te el co­n­te­ne­dor y añade la apli­ca­ción a tu vista general. Tras unos instantes, n8n estará listo para usar en CasaOS.

Paso 5: iniciar y abrir n8n

Una vez co­m­ple­ta­da la in­s­ta­la­ción de n8n con CasaOS, podrás iniciar n8n di­re­c­ta­me­n­te desde la interfaz de CasaOS. Para ello, ve a la sección “Installed Apps” del panel de control. Allí verás todas las apli­ca­cio­nes in­s­ta­la­das en tu servidor. Busca n8n en la lista. Si n8n aún no se está eje­cu­ta­n­do, haz clic en “Start”. En la mayoría de los casos, la apli­ca­ción se inicia au­to­má­ti­ca­me­n­te después de la in­s­ta­la­ción.

Close

En cuanto n8n esté activo, podrás abrir la interfaz en el navegador. Para ello, abre una nueva pestaña e introduce la siguiente dirección:

http://TU-IP-DEL-SERVIDOR:5678

Sustituye TU-IP-DEL-SERVIDOR por la dirección IP real de tu servidor. El puerto 5678 es el puerto estándar de n8n y debe indicarse.

Si todo está co­n­fi­gu­ra­do co­rre­c­ta­me­n­te, se abrirá di­re­c­ta­me­n­te la interfaz de usuario de n8n. En el primer inicio, no­r­ma­l­me­n­te verás el editor de n8n o una breve página de co­n­fi­gu­ra­ción. A partir de este punto puedes empezar a crear tu primer flujo de trabajo.

Paso 6: co­n­fi­gu­ra­ción básica para el uso en pro­du­c­ción

Después de instalar e iniciar n8n con CasaOS, conviene realizar algunas co­n­fi­gu­ra­cio­nes básicas. Estas son es­pe­cia­l­me­n­te im­po­r­ta­n­tes si no quieres usar n8n solo para pruebas, sino eje­cu­tar­lo de forma pe­r­ma­ne­n­te y fiable. Sin esta co­n­fi­gu­ra­ción, más adelante pueden surgir problemas, por ejemplo, con los webhooks, el acceso desde el exterior o la seguridad general de tu in­s­ta­la­ción.

Co­n­fi­gu­rar un dominio o su­b­do­mi­nio

De forma pre­de­te­r­mi­na­da, n8n solo es accesible a través de la dirección IP de tu servidor y una conexión HTTP sin cifrar. Sin embargo, esto no es su­fi­cie­n­te para el uso en pro­du­c­ción. En su lugar, deberías acceder a n8n a través de un dominio fijo y proteger el acceso mediante HTTPS. De este modo, la conexión se cifra, el acceso es mucho más seguro y muchas in­te­gra­cio­nes y webhooks funcionan de forma más fiable.

Configura primero tu propio dominio o su­b­do­mi­nio, por ejemplo, n8n.tudominio.es. Este dominio debe apuntar a la dirección IP de tu servidor mediante una entrada DNS, no­r­ma­l­me­n­te un registro A. Una vez conectado co­rre­c­ta­me­n­te, podrás acceder a n8n mediante una URL clara y fácil de recordar, en lugar de tener que usar una dirección IP.

Co­n­fi­gu­rar un proxy inverso

Para que las so­li­ci­tu­des a este dominio lleguen co­rre­c­ta­me­n­te a n8n con CasaOS, también necesitas un proxy inverso. Este actúa como in­te­r­me­dia­rio entre Internet y tu apli­ca­ción. Algunas so­lu­cio­nes ha­bi­tua­les son NGINX o Caddy. El proxy inverso se encarga de recibir las so­li­ci­tu­des entrantes a tu dominio y re­di­ri­gi­r­las in­te­r­na­me­n­te al puerto de n8n. Al mismo tiempo, también gestiona la co­n­fi­gu­ra­ción y ad­mi­ni­s­tra­ción de los ce­r­ti­fi­ca­dos HTTPS.

Para el cifrado puedes utilizar Let’s Encrypt. Se trata de un servicio gratuito que emite au­to­má­ti­ca­me­n­te ce­r­ti­fi­ca­dos SSL válidos y los renueva pe­rió­di­ca­me­n­te. Muchos proxies inversos ya admiten Let’s Encrypt de forma nativa, por lo que la co­n­fi­gu­ra­ción suele ser bastante sencilla. Con HTTPS te aseguras de que la conexión esté protegida y de que los na­ve­ga­do­res no marquen tu apli­ca­ción como insegura.

Definir variables de entorno

Además, conviene es­ta­ble­cer algunas variables de entorno im­po­r­ta­n­tes para que n8n con CasaOS detecte co­rre­c­ta­me­n­te desde qué dirección es accesible y cómo debe generar los webhooks. Una co­n­fi­gu­ra­ción típica tiene este aspecto:

N8N_HOST=n8n.tudominio.es
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.tudominio.es/
N8N_PROXY_HOPS=1

Estos valores indican a n8n que la apli­ca­ción está di­s­po­ni­ble a través de tu dominio y de una conexión HTTPS. Si ejecutas n8n con CasaOS, puedes definir estas variables di­re­c­ta­me­n­te en la co­n­fi­gu­ra­ción de la apli­ca­ción. Para ello, abre la sección “Installed Apps”, se­le­c­cio­na n8n e introduce los valores en el apartado de variables de entorno. Después, guarda los cambios y reinicia el co­n­te­ne­dor para que la co­n­fi­gu­ra­ción se aplique.

Para el uso en pro­du­c­ción, también deberías es­ta­ble­cer la variable de entorno N8N_ENCRYPTION_KEY. Esta clave se utiliza para cifrar datos sensibles dentro de n8n, como cre­de­n­cia­les de acceso o claves de API. Si no defines una clave propia, n8n generará au­to­má­ti­ca­me­n­te una aleatoria. Esto puede causar problemas al acceder a las cre­de­n­cia­les guardadas tras un reinicio o un cambio de co­n­te­ne­dor.