Variáveis de ambiente: Nodes e community nodes
24 variáveis das versões 1.123.92, 2.45.7 e 3.0.1
Community nodes, Nodes incluídos ou excluídos, módulos liberados no Code node e limites dos Nodes de compressão e importação. 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.
Lista JSON de community nodes, com nome, versão e checksum opcional, conferida a cada inicialização. Só tem efeito com
N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENVligado.Token de autenticação no registro npm, para instalar community nodes de um registro privado.
Liga a instalação e o uso de community nodes.
Faz a lista de
N8N_COMMUNITY_PACKAGEScontrolar os community nodes instalados. A cada inicialização, o n8n instala os que faltam, corrige versões e remove os que não estão na lista. A tela de community nodes fica somente leitura nesse modo.Impede que os community nodes já instalados sejam carregados na inicialização.
URL do registro npm de onde o n8n baixa os community nodes.
Tamanho máximo em bytes do conteúdo descompactado pelo Compression node. O padrão caiu de 2 GiB na 2.x para 256 MiB na 3.x. Arquivos acima do limite fazem o Node falhar. Para manter o limite antigo, defina
2147483648.Na 2.x, o n8n avisa quando a variável não está definida, porque o padrão cairia para 256 MiB.
Quantidade máxima de arquivos dentro de um ZIP aceito pelo Compression node. O padrão caiu de 5000 na 2.x para 1000 na 3.x. Para manter o limite antigo, defina
5000.Na 2.x, o n8n avisa quando a variável não está definida, porque o padrão cairia para 1000.
Pastas com Nodes personalizados carregados pelo n8n, separadas por ponto e vírgula.
Recusa Nodes defasados. Salvar ou importar um workflow que acrescente ou altere um desses Nodes falha. Workflows salvos que já têm Nodes defasados continuam rodando. Com
false, a recusa fica desligada.Quantidade máxima de arquivos em um pacote importado.
Tamanho máximo descompactado em bytes de cada arquivo de um pacote importado.
Tamanho máximo em caracteres do caminho de cada arquivo de um pacote importado.
Tamanho total máximo descompactado em bytes de um pacote importado.
Permite usar Python no Code node.
Reinstala na inicialização os community nodes que constam no banco mas não estão no disco, útil quando o volume de
~/.n8n/nodesnão é persistido.Permite instalar e carregar community nodes não verificados pelo n8n. O padrão mudou de
trueparafalsena 3.x. Depois da atualização, os pacotes não verificados já instalados deixam de carregar. Definatruepara manter o comportamento da 2.x.Na 2.x, o n8n avisa quando a variável não está definida, porque o padrão mudaria para
false.Mostra e sugere na busca de Nodes os community nodes verificados pelo n8n.
Tipo de Node usado como Error Trigger padrão quando uma execução falha.
Tipos de Node que o n8n não carrega, em lista JSON. Na 2.x e na 3.x, o padrão exclui o
Execute Commande oLocal File Triggerpor segurança. Uma lista vazia,[], libera todos os Nodes.Tipos de Node que o n8n carrega, em lista JSON. Vazio, carrega todos os disponíveis.
Limite de memória em MB do sandbox SQL usado pelo Merge node no modo de consulta SQL.
Módulos nativos do Node.js que o Code node em JavaScript pode importar, separados por vírgula. Use
*para liberar todos. O padrão não libera nenhum.Módulos npm externos, instalados em
n8n/node_modules, que o Code node em JavaScript pode importar, separados por vírgula. O padrão não libera nenhum.