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

Actualizar n8n

Para actualizar la versión de n8n en tu cloud, utiliza este tutorial.

Solución al error "User location is not supported" en Gemini API

Aqui tienes una guía para solucionar el error "User location is not supported" en Gemini API.