Ir para o conteúdo
Promovaweb

Variáveis de ambiente: External hooks

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

Arquivos de hooks do backend e URLs de hooks do frontend que o n8n carrega ao iniciar. 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.

  • URLs de arquivos de hooks externos carregados pelo editor, separadas por ponto e vírgula.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminhos dos arquivos que definem hooks externos do backend, separados pelo caractere de EXTERNAL_HOOK_FILES_SEPARATOR.

    Tipo
    Lista
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Separador dos caminhos em EXTERNAL_HOOK_FILES. O padrão é dois-pontos. No Windows, use ponto e vírgula.

    Tipo
    String
    Padrão
    :
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_PRE_EXECUTE_ERROR_CREATES_EXECUTION
    • Removida na 3.x
    • Fora da documentação

    Na 2.x, com true, um erro no hook externo workflow.preExecute ainda criava uma execução com falha, registrada como uso de produção. A 3.x remove a variável e não cria a execução nesse caso.

    Na 3.x, o n8n ignora a variável e pede para removê-la. Se você usava essas execuções com falha para alertas, mova o alerta para o próprio hook.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x não aceita