Las variables de entorno más importantes explicadas (N8N_HOST, WEBHOOK_URL, GENERIC_TIMEZONE ...)

Quien aloja por sí mismo una instancia de n8n configura ajustes centrales como la accesibilidad, la zona horaria, la base de datos y la seguridad no a través de la interfaz, sino mediante variables de entorno que se establecen al iniciar el contenedor o el proceso. De las más de cien variables documentadas, solo un puñado son realmente decisivas para la mayoría de las instalaciones autoalojadas alemanas, por ejemplo N8N_HOST para el nombre de host, WEBHOOK_URL para el acceso público detrás de un reverse proxy o GENERIC_TIMEZONE para que los workflows programados se disparen a la hora correcta. Este artículo ordena las variables más relevantes en la práctica por área temática y muestra en cada caso un ejemplo de uso. Fecha: julio de 2026.

Configuración básica: accesibilidad, URL y zona horaria

Estas variables determinan cómo es accesible n8n interna y externamente, y en qué zona horaria se ejecutan los workflows programados.

• N8N_HOST: Determina bajo qué nombre de host es accesible n8n internamente, el valor predeterminado es localhost, para un servidor con dominio propio por ejemplo n8n.suempresa.de.
• N8N_PORT: El puerto en el que escucha el proceso n8n, valor predeterminado 5678, relevante cuando varios servicios se ejecutan en paralelo en el mismo servidor.
• N8N_PROTOCOL: Determina si n8n se contacta internamente a través de http o https, el valor predeterminado es http, detrás de un reverse proxy que termina TLS suele permanecer en http internamente.
• N8N_EDITOR_BASE_URL: La URL pública bajo la cual los usuarios acceden al editor, también se usa para enlaces de correo electrónico y redirecciones SAML, ejemplo https://n8n.suempresa.de.
• WEBHOOK_URL: Se establece manualmente cuando n8n se ejecuta detrás de un reverse proxy, para que los webhooks entrantes usen la dirección pública correcta, ejemplo https://n8n.suempresa.de/.
• GENERIC_TIMEZONE: La zona horaria de la instancia de n8n, valor predeterminado es America/New_York, para instalaciones alemanas aquí debe ir prácticamente siempre Europe/Berlin, de lo contrario los disparadores cron y de programación se activan a la hora incorrecta.

Seguridad y protección de datos

Especialmente para empresas para las que la soberanía de datos alemana y el control sobre sus propios datos son importantes, vale la pena echar un vistazo detallado a las variables relevantes para la seguridad.

• N8N_ENCRYPTION_KEY: La clave con la que n8n cifra las credenciales en la base de datos, se genera aleatoriamente si no se especifica, debería fijarse de forma permanente y guardarse de forma segura en instalaciones productivas, ya que las credenciales guardadas ya no se pueden descifrar tras una reconstrucción.
• N8N_SECURE_COOKIE: Garantiza que las cookies solo se transmitan a través de HTTPS, valor predeterminado true, solo debería ponerse en false para operación de prueba puramente HTTP sin TLS.
• N8N_BLOCK_ENV_ACCESS_IN_NODE: Impide que los usuarios accedan a las variables de entorno del servidor a través de expresiones o del nodo Code, valor predeterminado false, se recomienda true para instancias multiusuario con credenciales sensibles.
• N8N_DIAGNOSTICS_ENABLED: Controla si n8n envía datos de telemetría anonimizados al fabricante, valor predeterminado true, quien quiera máxima soberanía de datos pone aquí false.

Base de datos y operación

Para la operación productiva, la mayoría de las instalaciones cambian de la base de datos SQLite incluida a PostgreSQL, lo cual se configura mediante variables propias.

• DB_TYPE: Determina la base de datos utilizada, valor predeterminado sqlite, postgresdb es el valor habitual para entornos productivos con varios usuarios simultáneos.
• DB_POSTGRESDB_HOST: El nombre de host del servidor PostgreSQL, valor predeterminado localhost, para una base de datos separada por ejemplo el nombre de host interno del contenedor de base de datos.
• DB_POSTGRESDB_DATABASE: El nombre de la base de datos PostgreSQL, valor predeterminado n8n, se puede adaptar para varias instancias en el mismo servidor.
• DB_POSTGRESDB_USER / DB_POSTGRESDB_PASSWORD: Credenciales para la conexión PostgreSQL, sin valor predeterminado para la contraseña, no deberían, como cualquier contraseña de base de datos, quedar en texto plano en el repositorio, sino gestionarse mediante un secret.
• N8N_PROXY_HOPS: Indica detrás de cuántos reverse proxies se ejecuta n8n, valor predeterminado 0, típicamente 1 con un único Nginx o Traefik delante, para que n8n determine correctamente la IP real del cliente.

La mayoría de los problemas al autoalojar n8n no surgen por variables faltantes, sino por URLs mal configuradas o una zona horaria que no coincide con la ubicación del servidor. Quien quiera configurar, proteger o migrar su propia instancia de n8n a Postgres, encuentra en los servicios de n8n de NordFlux apoyo para la configuración y puesta en marcha.

Preguntas frecuentes sobre las variables de entorno de n8n

¿Dónde se establecen las variables de entorno en n8n?

Depende del tipo de instalación. Con Docker esto se hace mediante flags -e o un archivo .env en el docker-compose.yml, con una instalación clásica como variables de entorno del sistema que se establecen antes de iniciar el proceso n8n.

¿Qué pasa si no establezco N8N_ENCRYPTION_KEY?

n8n genera entonces automáticamente una clave aleatoria en el primer inicio. Si esta se pierde, por ejemplo durante una reconstrucción del contenedor sin almacenamiento persistente, las credenciales ya guardadas ya no se pueden descifrar.

¿Siempre tengo que establecer WEBHOOK_URL?

Solo si n8n se ejecuta detrás de un reverse proxy o bajo una dirección pública diferente a la configurada internamente. Con acceso directo a través de N8N_HOST y N8N_PORT, la variable normalmente no es necesaria.

¿Puedo cambiar las variables de entorno posteriormente?

Sí, la mayoría de las variables solo surten efecto tras reiniciar el proceso n8n. Los workflows en ejecución y los datos ya guardados no se ven afectados, siempre que la conexión a la base de datos no cambie.

Más detalles sobre todas las variables documentadas se encuentran en la documentación de n8n sobre variables de entorno así como específicamente sobre la configuración de la base de datos.