Configuración inicial y variables de entorno básicas

Esta lección es fundamental para tener una instalación de N8N profesional y “a prueba de futuro”. Aprendemos a manipular la configuración interna de N8N a través de EasyPanel.

🌍 ¿Qué son las Variables de Entorno?

Son configuraciones que le dicen a N8N cómo comportarse antes de arrancar. Se configuran en la pestaña “Environment” (Entorno) de tu servicio en EasyPanel.

🔑 Variables Críticas Explicadas

  1. GENERIC_TIMEZONE:
    • Por defecto viene en horario de Nueva York.
    • Debes cambiarlo a tu zona (ej: Europe/Madrid) para que los nodos de “Schedule” (Cron) funcionen cuando esperas.
  2. N8N_ENCRYPTION_KEY (La más importante):
    • N8N encripta tus credenciales (Google, OpenAI, etc.) en la base de datos.
    • Si no defines esta variable, N8N genera una aleatoria y la guarda en un archivo interno.
    • El Riesgo: Si migras tu N8N a otro servidor y no tienes esa clave, perderás acceso a todas tus cuentas conectadas.
    • La Solución: Define una cadena de texto segura (contraseña larga) en esta variable antes de la primera ejecución.
  3. Configuración de Correo (SMTP):
    • Variables: N8N_EMAIL_MODE, N8N_SMTP_HOST, N8N_SMTP_PORT, etc.
    • Diferencia: Esto no es para enviar emails en tus automatizaciones (para eso usas el nodo Gmail/Outlook), sino para que el sistema N8N te envíe correos a ti (ej: “Has olvidado tu contraseña” o “El workflow ha fallado”).
  4. Desbloqueo de Funciones:
    • Variables para habilitar paquetes de la comunidad y plantillas que a veces vienen ocultas.
# 1. Identidad y Tiempo
GENERIC_TIMEZONE=Europe/Madrid

# 2. Seguridad
N8N_ENCRYPTION_KEY=iaLRaOmc9DdbTA5vgVlLBD5lwDWqmLSb05W1rz6V6Lr
N8N_RESTRICT_ENVIRONMENT_VARIABLES_TO=*
N8N_BLOCK_ENV_ACCESS_IN_NODE=false

# 3. Correo (Opcional pero recomendado)
N8N_EMAIL_MODE=smtp
N8N_SMTP_HOST=mail.va360.pro
N8N_SMTP_PORT=465
N8N_SMTP_USER=valen@va360.pro
N8N_SMTP_PASS=passwordApp
N8N_SMTP_SENDER=valen@va360.pro

⚠️ El “Crash” en Directo y la Solución

El instructor demuestra un error común para que aprendas de él:

  • El Error: Intentar añadir una N8N_ENCRYPTION_KEY personalizada a una instalación de N8N que ya había arrancado previamente (y que ya tenía una clave autogenerada).
  • El Resultado: N8N entra en bucle de reinicio porque la clave nueva no coincide con la base de datos existente.
  • La Solución Correcta:
    1. Eliminar el servicio N8N en EasyPanel.
    2. Crear el servicio de nuevo.
    3. Antes de darle a “Start”, ir a la pestaña Entorno y pegar todas las variables.
    4. Arrancar el servicio (ahora se inicializará usando tu clave desde el principio).

💡 Consejo Pro: Guarda estas variables de entorno en un lugar seguro (como un gestor de contraseñas). Son la llave maestra de tu infraestructura de automatización.