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.
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
.envou as variáveis com sufixo_FILEno lugar deste recurso.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.Identificador do tipo de implantação, como
defaultoucloud, usado na telemetria e em alguns comportamentos internos.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.Módulos internos do n8n desligados, separados por vírgula.
Desliga a interface do editor. Útil em instâncias que só executam workflows ou só recebem webhooks.
Busca e mostra os avisos dinâmicos publicados pelo n8n, como anúncios dentro do editor.
Endereço de onde o n8n busca os avisos dinâmicos do editor.
URL pública do editor. Também aparece nos emails enviados pelo n8n e no redirecionamento do login por SAML.
Módulos internos do n8n ligados, separados por vírgula. Na 3.x, o Chat Hub vem desligado e volta com
chat-hubna lista, mantendo os módulos que você já liga, comoN8N_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-hubda lista antes de atualizar para a 4.x.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.
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.
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.
Tempo em segundos que o n8n espera as execuções em andamento terminarem antes de encerrar o processo.
Mostra a mensagem de vagas do n8n no console das ferramentas de desenvolvedor do navegador.
Nome do host pelo qual o n8n é acessado.
Endereço IP que o n8n escuta. O padrão
::aceita conexões em todas as interfaces, IPv4 e IPv6.Caminho da URL que publica o n8n, para instalações atrás de um proxy em um subcaminho.
Mostra as perguntas de personalização ao criar o primeiro usuário e adapta sugestões do editor às respostas.
Porta HTTP do n8n.
Roda o n8n em modo de prévia, usado pelo próprio n8n para demonstrações.
Protocolo usado para acessar o n8n,
httpouhttps. Atrás de um proxy reverso com HTTPS, como o Traefik, definahttpspara as URLs geradas saírem corretas.Quantidade de proxies reversos na frente do n8n. Com Traefik ou Nginx na frente, use
1para o n8n ler o IP real do visitante no cabeçalhoX-Forwarded-For.Tecnologia usada para enviar atualizações em tempo real ao editor:
websocketousse.Canal da versão, como
stable,betaounightly. Afeta a busca por atualizações e alguns padrões internos. A imagem oficial já define o valor.Caminho do certificado SSL usado quando o próprio n8n atende em HTTPS.
Caminho da chave privada SSL usada quando o próprio n8n atende em HTTPS.
Liga a busca e a exibição dos templates de workflow no editor.
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.
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ê.
Pasta-base da pasta
.n8n, que guarda o banco SQLite, a chave de criptografia e outros arquivos da instância.Mostra no editor o aviso de novas versões do n8n.
Endereço de onde o n8n busca as informações de versões.
Link exibido no painel de versões, com as instruções de atualização.
Mostra no editor as novidades de cada versão. Exige os avisos de versão ligados.
Endereço de onde o n8n busca os artigos de novidades.
Modo de execução do Node.js, como
productionoudevelopment. A imagem oficial já define o valor.Endereço da API usado ao compilar o pacote
n8n-editor-uimanualmente, para o editor saber onde está o backend.