Ir para o conteúdo
Promovaweb

Variáveis de ambiente: Implantação e servidor

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

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. 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.

  • Liga o modo só canvas, que esconde cabeçalho, barra lateral e demais elementos da interface ao abrir um workflow. Disponível a partir da 2.15.

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

    Lia a configuração a partir de arquivos JSON. A variável não aparece mais no código. O n8n avisa na inicialização quando ela está definida.

    Nas três linhas, o n8n pede para usar arquivos .env ou as variáveis com sufixo _FILE no lugar deste recurso.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_DEPLOYMENT_ARTIFACT
    • Fora da documentação

    Artefato oficial que instalou o n8n, com a versão, como helm-chart/1.14.0. O próprio artefato define o valor, usado só na telemetria.

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

    Identificador do tipo de implantação, como default ou cloud, usado na telemetria e em alguns comportamentos internos.

    Tipo
    String
    Padrão
    default
    Versões
    1.x aceita2.x aceita3.x aceita
  • Reinicia o n8n automaticamente quando arquivos do código-fonte mudam. Serve ao desenvolvimento do próprio n8n e ao teste de community nodes com n8n-node dev --external-n8n.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Módulos internos do n8n desligados, separados por vírgula.

    Tipo
    Lista
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Desliga a interface do editor. Útil em instâncias que só executam workflows ou só recebem webhooks.

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

    Busca e mostra os avisos dinâmicos publicados pelo n8n, como anúncios dentro do editor.

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

    Endereço de onde o n8n busca os avisos dinâmicos do editor.

    Tipo
    String
    Padrão
    https://api.n8n.io/api/banners
    Versões
    1.x aceita2.x aceita3.x aceita
  • URL pública do editor. Também aparece nos emails enviados pelo n8n e no redirecionamento do login por SAML.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_ENABLED_MODULES
    • Defasada
    • Fora da documentação

    Módulos internos do n8n ligados, separados por vírgula. Na 3.x, o Chat Hub vem desligado e volta com chat-hub na lista, mantendo os módulos que você já liga, como N8N_ENABLED_MODULES=agents,chat-hub.

    Na 3.x, o n8n avisa que o Chat Hub está defasado e será removido na 4.x. Retire chat-hub da lista antes de atualizar para a 4.x.

    Tipo
    Lista
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Chave usada para criptografar as credenciais no banco. Sem valor, o n8n gera uma chave aleatória na primeira inicialização e a grava no arquivo de configuração. Guarde essa chave junto do backup, porque sem ela as credenciais não podem ser lidas em outra instância.

    Tipo
    String
    Padrão
    Random key generated by n8n
    Versões
    1.x aceita2.x aceita3.x aceita
  • Liga a rotação da chave de criptografia em todas as instâncias, principal e workers. Na 2.x, a opção é desligada por padrão e, até a 2.40.3, não podia ser desfeita. Na 3.x, a rotação vem ligada por padrão. Faça backup completo do banco antes de mudar o valor.

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

    Objeto JSON que força o valor de feature flags internas do n8n, por nome. JSON inválido faz o n8n ignorar todas as substituições. Serve a testes e suporte, não ao uso comum.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo em segundos que o n8n espera as execuções em andamento terminarem antes de encerrar o processo.

    Tipo
    Number
    Padrão
    30
    Versões
    1.x aceita2.x aceita3.x aceita
  • Mostra a mensagem de vagas do n8n no console das ferramentas de desenvolvedor do navegador.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Nome do host pelo qual o n8n é acessado.

    Tipo
    String
    Padrão
    localhost
    Versões
    1.x aceita2.x aceita3.x aceita
  • Endereço IP que o n8n escuta. O padrão :: aceita conexões em todas as interfaces, IPv4 e IPv6.

    Tipo
    String
    Padrão
    ::
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminho da URL que publica o n8n, para instalações atrás de um proxy em um subcaminho.

    Tipo
    String
    Padrão
    /
    Versões
    1.x aceita2.x aceita3.x aceita
  • Mostra as perguntas de personalização ao criar o primeiro usuário e adapta sugestões do editor às respostas.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Porta HTTP do n8n.

    Tipo
    Number
    Padrão
    5678
    Versões
    1.x aceita2.x aceita3.x aceita
  • Roda o n8n em modo de prévia, usado pelo próprio n8n para demonstrações.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Protocolo usado para acessar o n8n, http ou https. Atrás de um proxy reverso com HTTPS, como o Traefik, defina https para as URLs geradas saírem corretas.

    Tipo
    Enum
    Padrão
    http
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • http
    • https
  • Quantidade de proxies reversos na frente do n8n. Com Traefik ou Nginx na frente, use 1 para o n8n ler o IP real do visitante no cabeçalho X-Forwarded-For.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tecnologia usada para enviar atualizações em tempo real ao editor: websocket ou sse.

    Tipo
    Enum
    Padrão
    websocket
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • sse
    • websocket
  • N8N_RELEASE_TYPE
    • Fora da documentação

    Canal da versão, como stable, beta ou nightly. Afeta a busca por atualizações e alguns padrões internos. A imagem oficial já define o valor.

    Tipo
    Enum
    Padrão
    dev
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • stable
    • beta
    • nightly
    • dev
    • rc
  • Caminho do certificado SSL usado quando o próprio n8n atende em HTTPS.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminho da chave privada SSL usada quando o próprio n8n atende em HTTPS.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Liga a busca e a exibição dos templates de workflow no editor.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Endereço da API de templates. Troque para usar uma biblioteca própria, que precisa ter os mesmos endpoints e o mesmo formato de resposta da API do n8n.

    Tipo
    String
    Padrão
    https://api.n8n.io/api/
    Versões
    1.x aceita2.x aceita3.x aceita
  • Subdomínio do túnel do n8n para expor uma instância local. A documentação ainda cita a variável, mas o código das três linhas não a lê.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • Pasta-base da pasta .n8n, que guarda o banco SQLite, a chave de criptografia e outros arquivos da instância.

    Tipo
    String
    Padrão
    user-folder
    Versões
    1.x aceita2.x aceita3.x aceita
  • Mostra no editor o aviso de novas versões do n8n.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Endereço de onde o n8n busca as informações de versões.

    Tipo
    String
    Padrão
    https://api.n8n.io/api/versions/
    Versões
    1.x aceita2.x aceita3.x aceita
  • Link exibido no painel de versões, com as instruções de atualização.

    Tipo
    String
    Padrão
    https://docs.n8n.io/hosting/installation/updating/
    Versões
    1.x aceita2.x aceita3.x aceita
  • Mostra no editor as novidades de cada versão. Exige os avisos de versão ligados.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Endereço de onde o n8n busca os artigos de novidades.

    Tipo
    String
    Padrão
    https://api.n8n.io/api/whats-new
    Versões
    1.x aceita2.x aceita3.x aceita
  • NODE_ENV
    • Fora da documentação

    Modo de execução do Node.js, como production ou development. A imagem oficial já define o valor.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Endereço da API usado ao compilar o pacote n8n-editor-ui manualmente, para o editor saber onde está o backend.

    Tipo
    String
    Padrão
    http://localhost:5678/
    Versões
    1.x aceita2.x aceita3.x aceita