1. Requerimientos necesarios para seguir esta guía.

Todo usuario que siga esta guía debería tener los siguientes conocimientos:

Para crear el servidor y configurarlo:

• Comandos de consola en Linux (nivel básico, añadir/eliminar usuarios, instalar/eliminar paquetes, resolución de problemas o troubleshooting).
• Poder conectarse al servidor con SSH u otro protocolo.

Y para crear un flujo y probarlo:

• JavaScript (nivel básico, para hacer scripts en los nodos de código y para la configuración de variables).
• Python (nivel básico, también para los nodos de código, pero es opcional).

⚠️ Antes de instalar n8n o reportar un error a los desarrolladores, comprobaremos que el puerto 5678 está permitido en nuestro cortafuegos y en nuestro proveedor de servicios (Google Cloud, Azure, …).

⚠️ En caso de desplegar n8n en producción, nos aseguraremos de tener un dominio o subdominio a nuestra disposición, y apuntando a la IP de nuestro servidor. En esta guía, usaremos n8n.tudominio.com, que puede ser reemplazado por el dominio o subdominio conveniente.

2. Configuración inicial del servidor.

Para desplegar correctamente n8n en producción, vamos a tener que realizar configuraciones previas en nuestro servidor.

✍️ Nota: En caso de probarlo a nivel local (es decir, en tu propio ordenador), puedes saltarte toda esta configuración inicial.

2.1. Configuración de la fecha y hora del servidor.

Para configurar la fecha y hora del servidor, debemos ejecutar lo siguiente (por ejemplo, utilizaremos el huso horario de Madrid):

sudo ln -fs /usr/share/zoneinfo/Europe/Madrid /etc/localtime
sudo dpkg-reconfigure --frontend noninteractive tzdata

2.2. Configuración del servicio de sistema para n8n.

Configuraremos un servicio de arranque para n8n en segundo plano, para iniciar n8n automáticamente cuando se reinicia el servidor o ocurre algún error inesperado.

Debemos ejecutar el siguiente comando:

sudo bash -c 'cat > /etc/systemd/system/n8n.service << "EOF"
[Unit]
Description=N8N process manager
Documentation=https://n8n.io/
After=network.target
[Service]
Type=simple
User=n8n
LimitNOFILE=infinity
LimitNPROC=infinity
LimitCORE=infinity
Environment=PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin:/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin
PIDFile=/etc/n8n/n8n.pid
Restart=on-failure
ExecStart=/usr/bin/node /usr/bin/n8n
ExecReload=/bin/kill -HUP $MAINPID
ExecStop=/bin/kill -TERM $MAINPID
[Install]
WantedBy=multi-user.target
EOF'

Los límites de memoria y velocidad (LimitNOFILE, LimitNPROC y LimitCORE) los hemos puesto muy laxos (sin límites), ya que n8n también puede tener procesos muy intensos de memoria, dependiendo siempre de la cantidad de datos que consultamos.

Como el servidor es dedicado y este es el único servicio importante que tendremos ejecutando en segundo plano, podemos permitir que n8n pueda utilizar lo máximo de CPU y memoria RAM.

✍️ Nota: Sólo el núcleo (o kernel) del sistema operativo será quién limitará el servicio de n8n en caso de utilización muy brusca de CPU o memoria, para no irrumpir el funcionamiento del sistema operativo a nivel básico.

Vemos que el usuario que ejecuta dicho servicio (en User=n8n) se llama n8n (lo vamos a crear más adelante). Es muy importante ejecutar n8n sin ser superusuario (o root), para minimizar los permisos y no otorgar demasiados privilegios de usuario.

Por supuesto, el usuario n8n no tiene ningún acceso a comandos de superusuario, es decir, no forma parte de los grupos wheel o sudoers ni tampoco tendrá ningún acceso especial en /etc/sudoers.d/.

2.3. Configuración de las variables de entorno.

Las variables de entorno ayudan a arrancar n8n con unas especificaciones en concreto. Para guardar las variables de entorno, lo haremos en otro archivo de configuración de este servicio.

Ejecutaremos el siguiente comando:

sudo mkdir -p "/etc/systemd/system/n8n.service.d"
sudo bash -c 'cat > /etc/systemd/system/n8n.service.d/30-env.conf << "EOF"
[Service]
# Configuracion basica
# Para configuracion avanzada, puedes revisar:
# https://github.com/n8n-io/n8n/blob/2e97954/packages/cli/src/config/index.ts
# https://github.com/n8n-io/n8n/blob/2e97954/packages/cli/src/config/schema.ts
# https://github.com/n8n-io/n8n/blob/2e97954/packages/cli/src/config/types.ts
# https://github.com/n8n-io/n8n/blob/2e97954/packages/cli/src/config/utils.ts

# La API esta en https://n8n.tudominio.com/api/v1 por defecto
Environment=N8N_HOST="n8n.tudominio.com"
Environment=N8N_PORT="5678"
Environment=N8N_PROTOCOL="http"
Environment=NODE_ENV=production
Environment=N8N_RELEASE_TYPE=stable

# Acceso a webhooks y a la interfaz de edicion
Environment=VUE_APP_URL_BASE_API="http://localhost:5678"
Environment=N8N_EDITOR_BASE_URL="https://n8n.tudominio.com"
Environment=WEBHOOK_URL="https://n8n.tudominio.com"

# Habilitar notificaciones de nuevas versiones
Environment=N8N_VERSION_NOTIFICATIONS_ENABLED=true

# Deshabilitar la pagina de uso
Environment=N8N_HIDE_USAGE_PAGE=true

# Deshabilitar la seccion de plantillas de flujo de trabajo
Environment=N8N_TEMPLATES_ENABLED=false

# De https://www.thomasmartens.eu/n8n-disable-tracking
# Util para desplegar en localhost sin Internet
## Deshabilitar el banner de contratacion
Environment=N8N_HIRING_BANNER_ENABLED=false
## Deshabilitar diagnosticos del sistema
Environment=N8N_DIAGNOSTICS_CONFIG_FRONTEND=
Environment=N8N_DIAGNOSTICS_CONFIG_BACKEND=
Environment=N8N_DIAGNOSTICS_ENABLED=false
## Deshabilitar eventos de estadisticas
Environment=SKIP_STATISTICS_EVENTS=true
## Deshabilitar hooks externos
Environment=EXTERNAL_FRONTEND_HOOKS_URLS=
## Deshabilitar el proceso de onboarding
Environment=N8N_ONBOARDING_FLOW_DISABLED=true
Environment=N8N_PERSONALIZATION_ENABLED=false

# Establecer el nivel de LOGGING
Environment=N8N_LOG_LEVEL=info

# Configurar la salida de logs tanto a consola como a archivo
Environment=N8N_LOG_OUTPUT=console,file

# Establecer la ubicacion para guardar el archivo de logs
Environment=N8N_LOG_FILE_LOCATION=/home/n8n/n8n-verbose.log

# Establecer 10 MB como tamano maximo por archivo de log
Environment=N8N_LOG_FILE_MAXSIZE=50

# Establecer 60 como el numero maximo de archivos de log a mantener
Environment=N8N_LOG_FILE_MAXCOUNT=60

# Ver https://community.n8n.io/t/why-is-my-database-so-big/7981/13
Environment=EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
Environment=EXECUTIONS_DATA_SAVE_ON_ERROR=all
Environment=EXECUTIONS_DATA_SAVE_ON_PROGRESS=true
Environment=EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false
Environment=EXECUTIONS_DATA_MAX_AGE=168
Environment=DB_SQLITE_VACUUM_ON_STARTUP=true

# Activar la limpieza de datos automatica
Environment=EXECUTIONS_DATA_PRUNE=true

# Numero de horas despues de la ejecucion a partir del cual se deben eliminar, por defecto 14 dias
Environment=EXECUTIONS_DATA_MAX_AGE=336

# Numero de ejecuciones a almacenar
Environment=EXECUTIONS_DATA_PRUNE_MAX_COUNT=100

# Establecer la aplicacion de permisos en el archivo de configuracion
Environment=N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true

# Establecer la zona horaria por defecto
Environment=GENERIC_TIMEZONE=Europe/Madrid
EOF'

Leeremos detenidamente los comentarios respecto a cada una de las variables, para saber el contexto. Es muy importante también leernos la documentación de variables de entorno para saber más variables útiles y el detalle de cada una de ellas.

⚠️ Recuerda reemplazar n8n.tudominio.com por el dominio a tu elección.

✍️ Nota: Hemos puesto la interfaz de n8n en el puerto 5678, ya que el 
puerto 443 (HTTPS) es un puerto privilegiado que sólo puede ejecutar el 
usuario root. En caso de configurarlo así, vamos a tener problemas para hacer login o logout.

2.4. Creación del usuario n8n.

Tal como hemos mencionado anteriormente, el usuario n8n no tendrá ningún tipo de privilegio a excepción del propio servicio de n8n. Por supuesto, podremos poner el nombre de usuario que queramos, pero en caso de cambiarlo debemos cerciorarnos que todo apunta a este nuevo usuario.

Ejecutaremos el siguiente comando:

sudo useradd -m n8n -s /bin/bash

2.5. Configuración del HTTPS para n8n.

Para comunicar la interfaz web de n8n (ubicada al puerto 5678) vamos configurar un servidor web que haga de proxy. En pocas palabras, ejecutaremos un servidor web (nginx, por ejemplo) como root en el puerto 443, que redirigirá la petición al puerto 5678, que es donde se ubica la interfaz de n8n.

Servidor web Nginx

NGINX es un software de servidor web de código abierto, similar a Apache.

Para instalarlo, ejecutaremos lo siguiente:

sudo apt-get install -yq nginx

Para configurar el proxy inverso con Nginx, escribiremos lo siguiente:

sudo bash -c 'cat > /etc/nginx/sites-available/n8n.conf << "EOF"
# From https://github.com/sutidor/misc/blob/main/proxy-confs/n8n.subdomain.conf.sample
server {
  server_name n8n.tudominio.com;
  listen 80;
  location / {
    proxy_pass http://localhost:5678;

    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    chunked_transfer_encoding off;
    proxy_buffering off;
    proxy_cache off;
    proxy_read_timeout 86400;

    # config to set HTTPOnly and Secure Cookie
    proxy_cookie_path / "/; HTTPOnly; Secure";
  }
  location ~ ^/(webhook|webhook-test) {
    proxy_pass http://localhost:5678;

    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    chunked_transfer_encoding off;
    proxy_buffering off;
    proxy_cache off;
    proxy_read_timeout 86400;

   # config to set HTTPOnly and Secure Cookie
   proxy_cookie_path / "/; HTTPOnly; Secure";
  }
}
EOF'
# Activamos el servicio web de n8n
sudo ln -fs /etc/nginx/sites-available/n8n.conf /etc/nginx/sites-enabled/n8n.conf
# Reiniciamos Nginx
sudo service nginx reload

⚠️ Recuerda reemplazar n8n.tudominio.com por el dominio a tu elección.

Certbot

Para añadir un certificado seguro para la dirección de n8n, podemos utilizar Certbot, que creará un certificado seguro HTTPS mediante LetsEncrypt y lo renovará automáticamente cada cierto tiempo.

sudo apt-get -yq install python3-certbot-nginx

sudo certbot -d n8n.tudominio.com

y contestaremos en la consola las preguntas pertinentes que nos pregunte Certbot.

Veremos que el fichero que tenemos en /etc/nginx/sites-available/n8n.conf está cambiado (Certbot ha añadido sus directivas), debería quedar algo así:

# From https://github.com/sutidor/misc/blob/main/proxy-confs/n8n.subdomain.conf.sample
server {
  server_name n8n.tudominio.com;

  listen 443 ssl;
  ssl_certificate /etc/letsencrypt/live/n8n.tudominio.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/n8n.tudominio.com/privkey.pem;
  include /etc/letsencrypt/options-ssl-nginx.conf;
  ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

  location / {
    proxy_pass http://localhost:5678;

    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    chunked_transfer_encoding off;
    proxy_buffering off;
    proxy_cache off;
    proxy_read_timeout 86400;

    # config to set HTTPOnly and Secure Cookie
    proxy_cookie_path / "/; HTTPOnly; Secure";
  }

  location ~ ^/(webhook|webhook-test) {
    proxy_pass http://localhost:5678;

    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    chunked_transfer_encoding off;
    proxy_buffering off;
    proxy_cache off;
    proxy_read_timeout 86400;

    # config to set HTTPOnly and Secure Cookie
    proxy_cookie_path / "/; HTTPOnly; Secure";
  }
}
server {
  if ($host = n8n.tudominio.com) {
    return 301 https://$host$request_uri;
  } # managed by Certbot

  server_name n8n.tudominio.com;
  listen 80;
  return 404; # managed by Certbot
} 

⚠️ En caso de utilizar directamente esta plantilla, recuerda reemplazar n8n.tudominio.com por el dominio a tu elección.

3. Instalación de n8n y primer arranque.

Ya que vamos a instalar n8n en un servidor dedicado a ello, utilizaremos la vía de instalación con npm. También lo podemos instalar y configurar mediante Docker, pero al tener un servidor a propósito no hace falta ningún tipo de contenerización, además de ahorrarnos memoria y recursos.

Para instalar n8n es tan fácil como introducir los siguientes comandos:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt-get install -yq nodejs
sudo npm install n8n -g

Y así instalamos la última versión en producción. n8n también ofrece versiones next (beta), pero no son recomendables para instalar en producción, ya que no están probadas tan rigurosamente.

Para arrancar n8n es tan fácil como:

sudo systemctl daemon-reload; # Este comando es opcional, sólamente es necesario ejecutarlo cuando se modifiquen las variables de entorno establecidas

sudo service n8n start

A partir de aquí, nos saldrá un formulario inicial como este para rellenar nuestros datos:

✍️ Nota: En la versión actual de n8n (1.71.2), salvo que tengamos habilitado un método de recuperación de contraseñas (no contemplado en esta guía), no se utilizará el email introducido para campañas publicitarias de la empresa de n8n. También puedes poner cualquier email ([email protected]) ya que en ningún momento se verifica el email.

4. Actualizar n8n.

⚠️ Nota del autor: a causa de la configuración del servicio de sistema definida en el punto 2.2, las actualizaciones de n8n deben llevarse a cabo cuando ningún flujo esté ejecutándose.

✍️ Nota: Antes de actualizar, nos aseguraremos que tenemos una copia de seguridad reciente. En nuestro caso, configuramos las copias de seguridad utilizando una plantilla muy similar extraída de este enlace.

sudo npm install -g [email protected]  # Instalamos la nueva versión
sudo npm -g cache clean --force  # Limpiamos la caché de npm
sudo service n8n restart  # Reiniciamos el servicio