Variáveis de ambiente do n8n
722 variáveis em 31 categorias
Cada categoria tem a sua página, com tipo, valor padrão, valores aceitos e compatibilidade com as versões 1.123.92, 2.45.7 e 3.0.1. A lista sai do código de cada versão e das páginas de variáveis da documentação oficial, conferidos em 3 de novembro de 2026.
Instalação, rede e API
Implantação e servidor
Endereço, porta, protocolo e chave de criptografia da instância. Também reúne opções da interface, os módulos ligados e o tempo de desligamento.
N8N_HOSTN8N_PORTN8N_PROTOCOLN8N_ENCRYPTION_KEY
Endpoints e URLs
Caminhos de webhooks, formulários, REST e MCP, a URL pública dos webhooks e os limites de tamanho das requisições.
18 variáveisProxy e rede de saída
Proxy das requisições que os Nodes fazem para fora, a lista de exceções e o User-Agent enviado.
8 variáveisFuso horário e idioma
Fuso horário usado pelos agendamentos e idioma da interface.
3 variáveisAPI pública
Liga ou desliga a API pública e o Swagger. Define também o caminho da API e os limites de leitura e escrita.
12 variáveisLicença
Chave de ativação, renovação automática, servidor de licença e relatórios de uso da instância.
10 variáveis
Banco e armazenamento
Banco de dados
Conexão com PostgreSQL, SQLite e o MySQL da 1.x, com pool, timeouts, verificação da conexão e logs de consulta.
DB_TYPEDB_POSTGRESDB_HOSTDB_POSTGRESDB_DATABASEDB_POSTGRESDB_POOL_SIZE
Binary data e armazenamento externo
Onde o n8n guarda arquivos binários: no disco, no banco ou em S3 e Azure. Inclui caminho, tamanho máximo e validade.
26 variáveisCache e Redis
Cache em memória ou no Redis, com tamanho, tempo de vida e prefixo das chaves.
6 variáveisData tables
Tamanho máximo das data tables, aviso de limite, envio de arquivos e limpeza dos arquivos temporários.
6 variáveis
Execução e escala
Queue mode e escala
Queue mode com Redis e Bull, workers e pools de workers, configuração multi-main e recuperação da fila.
QUEUE_BULL_REDIS_HOSTQUEUE_BULL_REDIS_PORTN8N_MULTI_MAIN_SETUP_ENABLEDQUEUE_HEALTH_CHECK_ACTIVE
Execuções
O que o n8n guarda de cada execução e por quanto tempo. Inclui a limpeza automática, os timeouts, os limites de concorrência e a proteção de memória da 3.x.
37 variáveisTask runners
Execução do Code node em task runners de JavaScript e Python, com broker, tokens, timeouts e módulos liberados.
35 variáveisAgendamento
Agendador da instância, com intervalos, tentativas, lotes e tolerância a disparos atrasados. Inclui os cursores duráveis dos Nodes de polling.
33 variáveisExpressões
Motor que avalia as expressões, com isolamento, pool, memória, timeout e rastreamento das avaliações lentas.
17 variáveis
Segurança e acesso
Segurança
Acesso dos Nodes a arquivos e variáveis, cabeçalhos de segurança, cookies, senha mínima e sandbox de formulários e webhooks.
N8N_BLOCK_ENV_ACCESS_IN_NODEN8N_RESTRICT_FILE_ACCESS_TON8N_SECURE_COOKIEN8N_PASSWORD_MIN_LENGTH
Credenciais e OAuth
Credenciais preenchidas por variável ou endpoint, credenciais dinâmicas, acesso às credenciais de sistema da AWS e limites do servidor OAuth do n8n.
35 variáveisUsuários, email e 2FA
Envio de emails por SMTP, modelos das mensagens, dono da instância definido por variável e autenticação em dois fatores.
33 variáveisSSO, LDAP e SCIM
Login por SAML, OIDC e LDAP, provisionamento de usuários e o limite de requisições do SCIM.
25 variáveisSegredos externos
Cofres externos de segredos ligados ao n8n, com intervalo de atualização, timeouts e uso por projeto.
7 variáveisProteção contra SSRF
Proteção contra requisições a endereços internos, com listas de hosts e faixas de IP liberadas ou bloqueadas.
6 variáveis
Workflows, Nodes e IA
IA, agentes e MCP
AI Agent, agentes da instância, AI Assistant, sandbox, avaliações e o servidor MCP do n8n.
N8N_AI_ASSISTANT_BASE_URLN8N_AI_TIMEOUT_MAXN8N_MCP_BASE_URLN8N_AGENTS_TRACING_ENABLED
Workflows e histórico
Salvamento automático, publicação, colaboração no editor e limpeza do histórico de versões dos workflows.
28 variáveisNodes e community nodes
Community nodes, Nodes incluídos ou excluídos, módulos liberados no Code node e limites dos Nodes de compressão e importação.
24 variáveisApps
Limites de build, versões, artefatos e armazenamento dos apps, recurso novo da 3.x.
10 variáveisExternal hooks
Arquivos de hooks do backend e URLs de hooks do frontend que o n8n carrega ao iniciar.
4 variáveisSource control e ambientes
Tipo da chave SSH que o n8n gera para conectar os ambientes a um repositório Git.
1 variável
Logs e monitoramento
Logs e event bus
Nível, formato e destino dos logs, rotação de arquivos, event bus, log streaming e registro de atividades.
N8N_LOG_LEVELN8N_LOG_OUTPUTN8N_LOG_FORMATN8N_LOG_FILE_LOCATION
Métricas do Prometheus
Endpoint de métricas do Prometheus e os grupos de métricas e rótulos que ele expõe.
35 variáveisObservabilidade e telemetria
Rastreamento com OpenTelemetry, envio de erros ao Sentry e a telemetria de diagnóstico enviada ao n8n.
30 variáveisInsights
Coleta, compactação e retenção dos registros do painel de Insights, que mostra execuções, falhas e tempo economizado pelos workflows.
11 variáveis