Ir para o conteúdo
Promovaweb

Variáveis de ambiente: Endpoints e URLs

18 variáveis das versões 1.123.92, 2.45.7 e 3.0.1

Caminhos de webhooks, formulários, REST e MCP, a URL pública dos webhooks e os limites de tamanho das requisições. 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. Toda variável aceita o sufixo _FILE para ler o valor de um arquivo, útil para senhas e chaves em secrets do Docker.

  • N8N_ADDITIONAL_NON_UI_ROUTES
    • Fora da documentação

    Caminhos da URL, separados por dois-pontos, que não devem servir a interface do editor, como rotas de health check ou só de webhook.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Desliga os webhooks de produção no processo principal, para que só os processos dedicados a webhooks os atendam.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_ENDPOINT_FORM
    • Fora da documentação

    Caminho da URL dos formulários de produção.

    Tipo
    String
    Padrão
    form
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_ENDPOINT_FORM_TEST
    • Fora da documentação

    Caminho da URL dos formulários de teste.

    Tipo
    String
    Padrão
    form-test
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_ENDPOINT_FORM_WAIT
    • Fora da documentação

    Caminho da URL dos formulários que aguardam resposta em uma execução pausada.

    Tipo
    String
    Padrão
    form-waiting
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminho da URL do health check da instância.

    Tipo
    String
    Padrão
    healthz
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_ENDPOINT_MCP
    • Fora da documentação

    Caminho da URL dos endpoints MCP de produção, usados pelo MCP Server Trigger.

    Tipo
    String
    Padrão
    mcp
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_ENDPOINT_MCP_TEST
    • Fora da documentação

    Caminho da URL dos endpoints MCP de teste.

    Tipo
    String
    Padrão
    mcp-test
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminho da URL da API REST interna usada pelo editor.

    Tipo
    String
    Padrão
    rest
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminho da URL dos webhooks de produção.

    Tipo
    String
    Padrão
    webhook
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminho da URL dos webhooks de teste.

    Tipo
    String
    Padrão
    webhook-test
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminho da URL dos webhooks que retomam uma execução pausada pelo Wait node.

    Tipo
    String
    Padrão
    webhook-waiting
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tamanho máximo em MiB de cada arquivo recebido em webhooks com multipart/form-data.

    Tipo
    Number
    Padrão
    200
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tempo em milissegundos que o editor espera a resposta do health check antes de mostrar a instância como offline.

    Tipo
    Number
    Padrão
    5000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tamanho máximo em MiB do corpo das requisições recebidas pela API e pelos webhooks.

    Tipo
    Number
    Padrão
    16
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_SKIP_WEBHOOK_DEREGISTRATION_SHUTDOWN
    • Fora do código atual
    • Fora da documentação

    Evitava que o n8n removesse os webhooks registrados em serviços externos ao desligar. O n8n não faz mais esse registro e remoção na inicialização e no desligamento.

    Nas três linhas, o n8n pede para remover a variável porque ela não tem mais efeito.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • URL pública base dos webhooks de teste e de produção. Defina quando o n8n roda atrás de um proxy reverso, para os Nodes mostrarem o endereço público e não localhost. Substitui WEBHOOK_URL a partir da 2.35.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Nome antigo de N8N_WEBHOOK_URL, a URL pública base dos webhooks. Continua funcionando, mas está defasada desde a 2.35.

    Na 2.x e na 3.x, o n8n avisa na inicialização e pede para usar N8N_WEBHOOK_URL, que vale para webhooks de teste e de produção.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita