Ir para o conteúdo
Promovaweb

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

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Token de autenticação no registro npm, para instalar community nodes de um registro privado.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Liga a instalação e o uso de community nodes.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Faz a lista de N8N_COMMUNITY_PACKAGES controlar 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.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Impede que os community nodes já instalados sejam carregados na inicialização.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • URL do registro npm de onde o n8n baixa os community nodes.

    Tipo
    String
    Padrão
    https://registry.npmjs.org
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Number
    Padrão
    2.x21474836483.x268435456
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Number
    Padrão
    2.x50003.x1000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Pastas com Nodes personalizados carregados pelo n8n, separadas por ponto e vírgula.

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

    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.

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

    Quantidade máxima de arquivos em um pacote importado.

    Tipo
    Number
    Padrão
    5000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_IMPORT_MAX_ENTRY_BYTES
    • Fora da documentação

    Tamanho máximo descompactado em bytes de cada arquivo de um pacote importado.

    Tipo
    Number
    Padrão
    5242880
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_IMPORT_MAX_PATH_LENGTH
    • Fora da documentação

    Tamanho máximo em caracteres do caminho de cada arquivo de um pacote importado.

    Tipo
    Number
    Padrão
    1024
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_IMPORT_MAX_UNCOMPRESSED_BYTES
    • Fora da documentação

    Tamanho total máximo descompactado em bytes de um pacote importado.

    Tipo
    Number
    Padrão
    314572800
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Permite usar Python no Code node.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Reinstala na inicialização os community nodes que constam no banco mas não estão no disco, útil quando o volume de ~/.n8n/nodes não é persistido.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Permite instalar e carregar community nodes não verificados pelo n8n. O padrão mudou de true para false na 3.x. Depois da atualização, os pacotes não verificados já instalados deixam de carregar. Defina true para 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.

    Tipo
    Boolean
    Padrão
    1.xtrue2.xtrue3.xfalse
    Versões
    1.x aceita2.x aceita3.x aceita
  • Mostra e sugere na busca de Nodes os community nodes verificados pelo n8n.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tipo de Node usado como Error Trigger padrão quando uma execução falha.

    Tipo
    String
    Padrão
    n8n-nodes-base.errorTrigger
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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 Command e o Local File Trigger por segurança. Uma lista vazia, [], libera todos os Nodes.

    Tipo
    Lista
    Padrão
    1.xvazio2.xn8n-nodes-base.executeCommand,n8n-nodes-base.localFileTrigger3.xn8n-nodes-base.executeCommand,n8n-nodes-base.localFileTrigger
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tipos de Node que o n8n carrega, em lista JSON. Vazio, carrega todos os disponíveis.

    Tipo
    Lista
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Limite de memória em MB do sandbox SQL usado pelo Merge node no modo de consulta SQL.

    Tipo
    Number
    Padrão
    64
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

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