Primeros pasos con n8n

Instalación de n8n

Opción 1: Imagen Click&Go (Recomendada)

Para una instalación rápida y sin complicaciones, utiliza nuestra imagen Click&Go de n8n:

1. Accede a tu Cloud Server sin software instalado
2. Selecciona la imagen de n8n desde el catálogo
3. Presiona el botón Instalar

Nota importante: Si contrataste tu Cloud Server desde la página de N8N Cloud Hosting, este paso ya se realizó automáticamente durante la configuración inicial.

Opción 2: Instalación manual

Si prefieres tener control total sobre la instalación:

1. Inicia con una imagen Ubuntu mínima en tu Cloud Server
2. Sigue las instrucciones detalladas en la documentación oficial de n8n
3. Configura manualmente las dependencias y variables de entorno

Configuración de dominio y certificado SSL

Nuestra imagen Click&Go incluye una herramienta integrada para configurar automáticamente tu dominio y certificado SSL, preparando tu instancia para un entorno productivo y seguro.

Pasos para configurar:

1. Navega a la configuración: Ve a "Software y Accesos" en el menú lateral > pestaña "n8n" > botón "Configurar Dominio y SSL"
   
   

2. Configura tu dominio:

   1. Ingresa tu dominio o subdominio
   2. Verifica que esté apuntando a la IP de tu servidor
   3. Presiona "Continua

   

3. Espera la configuración: En unos minutos recibirás confirmación de que puedes acceder a n8n usando tu dominio personalizado.
   
   

⚠️ Importante: Esta funcionalidad solo está disponible para instalaciones realizadas con nuestra imagen Click&Go. Si optaste por la instalación manual, deberás configurar el dominio y SSL por tu cuenta.

Creación del usuario administrador

⚠️ Acción crítica inmediata

Una vez completada la configuración del dominio, es fundamental crear inmediatamente el usuario administrador:

1. Accede a tu instancia: Ingresa a tu dominio o subdominio recién configurado en el navegador
2. Completa el formulario de configuración inicial:
   • Nombre de usuario administrador
   • Contraseña segura (mínimo 8 caracteres)
   • Email válido para recuperación
3. Confirma la creación del usuario administrador
    

🚨 Advertencia de seguridad: Este formulario de configuración inicial es público y accesible por cualquier persona que conozca tu dominio. Si no lo completas inmediatamente, un tercero podría crear la cuenta administrador y tomar control total de tu instancia.

Listo!!! ya puedes comenzar a crear tus workflows.

Configuración avanzada de n8n con variables de entorno

En las instalaciones de n8n en Cloud Server, el archivo de configuración se encuentra en /root/app/.env.

Este archivo contiene variables de entorno importantes como:

• Configuración de base de datos
• Claves de cifrado
• Configuración de SMTP
• Variables de dominio y SSL
• Configuraciones de seguridad

⚠️ Importante: Solo accede a este archivo si necesitas realizar configuraciones avanzadas. Para la mayoría de casos, la configuración a través de la interfaz web es suficiente.

TIP!!! Antes de modificar el archivo .env genera un backup

cp /root/app/.env /root/app/.env.backup

Ejemplo de parámetros del archivo .env para configurar el envío de correos desde n8n

# Configuración de emails
N8N_EMAIL_MODE=smtp
N8N_SMTP_HOST=tu-servidor-smtp.com
N8N_SMTP_PORT=587
N8N_SMTP_USER=tu-email@dominio.com
N8N_SMTP_PASS=tu-contraseña-smtp
N8N_SMTP_SSL=false

⚠️ Importante: Luego de editar parámetros del archivo .env, es necesario que recargues el container de Docker para que el cambio se aplique.

cd /root/app && docker compose down && docker compose up -d

Comandos útiles para administración Docker

# Cambiar al directorio de la aplicación
cd /root/app

# Ver estado de los contenedores
docker compose ps

# Ver logs en tiempo real
docker compose logs -f n8n

# Reiniciar todos los servicios (no suficiente para cambios de variables de entorno)
docker compose restart

# Detener servicios
docker compose down

# Iniciar servicios
docker compose up -d

# Reconstruir contenedores (si hay cambios en imagen)
docker compose up -d --build

# Acceder al contenedor de n8n
docker compose exec n8n bash

# Ver logs específicos de n8n
docker compose logs n8n

Comandos para gestión de volúmenes y datos

# Backup de datos de n8n
docker compose exec n8n tar -czf /tmp/n8n-backup.tar.gz /home/node/.n8n

# Ver uso de espacio de volúmenes
docker system df

# Limpiar contenedores no utilizados
docker system prune