Ir para o conteúdo
Promovaweb

Variáveis de ambiente: Execuções

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

O que o n8n guarda de cada execução e por quanto tempo. Inclui a limpeza automática, os timeouts, os limites de concorrência e a proteção de memória da 3.x. 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.

  • Idade mínima em horas de uma execução finalizada para ser apagada de vez. A folga preserva as execuções recentes enquanto você monta o workflow.

    Tipo
    Number
    Padrão
    1
    Versões
    1.x aceita2.x aceita3.x aceita
  • Idade em horas a partir da qual uma execução finalizada é marcada para exclusão. O padrão de 336 horas equivale a 14 dias.

    Tipo
    Number
    Padrão
    336
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tamanho máximo em bytes dos resultados de uma execução carregados para exibição no editor. Execuções maiores aparecem sem os resultados. Não afeta nova tentativa, retomada nem recuperação. Com 0, o limite fica desligado.

    Tipo
    Number
    Padrão
    104857600
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Apaga execuções antigas de forma contínua, conforme idade e quantidade.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Intervalo em minutos entre as exclusões definitivas de execuções.

    Tipo
    Number
    Padrão
    15
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade máxima de execuções finalizadas mantidas no banco. A limpeza não corta no número exato. Com 0, não há limite.

    Tipo
    Number
    Padrão
    10000
    Versões
    1.x aceita2.x aceita3.x aceita
  • Intervalo em minutos entre as marcações de execuções para exclusão.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x aceita2.x aceita3.x aceita
  • EXECUTIONS_DATA_PRUNE_TIMEOUT
    • Fora do código atual
    • Fora da documentação

    Configurava a limpeza de execuções em versões antigas. Não tem mais efeito.

    Nas três linhas, o n8n pede para remover a variável porque ela não tem mais efeito.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • Salva os resultados das execuções manuais. Cada workflow pode trocar esse padrão nas configurações.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Salva os resultados das execuções de produção que falham: all salva e none descarta. Cada workflow pode trocar esse padrão.

    Tipo
    Enum
    Padrão
    all
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • all
    • none
  • Salva os resultados a cada Node executado, o que permite retomar uma execução interrompida. Aumenta as gravações no banco. Cada workflow pode trocar esse padrão.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Salva os resultados das execuções de produção bem-sucedidas: all salva e none descarta. Cada workflow pode trocar esse padrão.

    Tipo
    Enum
    Padrão
    all
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • all
    • none
  • Modo de execução: regular executa no próprio processo do n8n e queue distribui as execuções para workers pelo Redis.

    Tipo
    Enum
    Padrão
    regular
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • regular
    • queue
  • EXECUTIONS_PROCESS
    • Defasada
    • Fora da documentação

    Escolhia entre os modos main e own de execução. O modo own deixou de existir em maio de 2023.

    Nas três linhas, o n8n recusa iniciar com o modo own e pede para remover a variável. Para isolar e escalar execuções, use o queue mode.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tempo máximo em segundos de uma execução de workflow. No limite, a execução é interrompida à força. Com -1, não há limite, o padrão atual. O código prevê mudar esse padrão em uma versão futura.

    Tipo
    Number
    Padrão
    -1
    Versões
    1.x aceita2.x aceita3.x aceita
  • Limite máximo em segundos que cada workflow pode definir no próprio tempo limite. O padrão equivale a uma hora.

    Tipo
    Number
    Padrão
    3600
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade máxima de execuções de avaliação rodando ao mesmo tempo. Com -1, não há limite.

    Tipo
    Number
    Padrão
    -1
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade máxima de execuções de produção rodando ao mesmo tempo no modo regular. Com -1, não há limite. No queue mode, o limite vem da opção --concurrency de cada worker.

    Tipo
    Number
    Padrão
    -1
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_ENGINE_AUTH_SECRET
    • Fora da documentação

    Segredo compartilhado entre o plano de controle e o motor de execução separado. Recurso em desenvolvimento, ainda não pronto para uso.

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

    Endereço usado pelo plano de controle para chegar ao motor de execução separado. Defina quando o motor não responde em http://127.0.0.1:<porta>. Recurso em desenvolvimento.

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

    Endereço usado pelo motor de execução para chegar ao plano de controle. Recurso em desenvolvimento.

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

    Endereço que o servidor do plano de controle escuta. O padrão aceita só conexões locais. Recurso em desenvolvimento.

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

    Porta do servidor do plano de controle, separada da API do editor para poder ficar atrás de firewall. Recurso em desenvolvimento.

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

    URL de conexão Postgres do motor de execução. Sem valor, o motor sobe só com health check. Recurso em desenvolvimento, ainda não pronto para uso.

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

    Interface de rede que o servidor HTTP do motor de execução escuta. Recurso em desenvolvimento.

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

    Onde roda o motor de execução: in-process no próprio processo principal ou remote em outro processo, iniciado com n8n engine. O modo remote exige N8N_ENGINE_BASE_URL e N8N_ENGINE_AUTH_SECRET. Recurso em desenvolvimento.

    Tipo
    Enum
    Padrão
    in-process
    Versões
    1.x não aceita2.x aceita3.x aceita
    Valores
    • in-process
    • remote
  • N8N_ENGINE_PORT
    • Fora da documentação

    Porta do servidor HTTP do motor de execução. Recurso em desenvolvimento.

    Tipo
    Number
    Padrão
    3000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo em milissegundos que o plano de controle espera a resposta de uma execução antes de responder o próprio webhook. Em respostas por streaming, o prazo reinicia a cada trecho. Recurso em desenvolvimento.

    Tipo
    Number
    Padrão
    120000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Onde o n8n guarda os resultados das execuções: database, o padrão, filesystem, s3 ou azure.

    Tipo
    String
    Padrão
    database
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_MEMORY_GUARD_CRITICAL_LEVEL
    • Nova na 3.x
    • Fora da documentação

    Experimental. Fração do limite de memória, de 0 a 1, a partir da qual o n8n interrompe uma execução na hora, sem nova checagem. Precisa ficar acima de N8N_MEMORY_GUARD_STOP_LEVEL.

    Tipo
    Number
    Padrão
    0.95
    Versões
    1.x não aceita2.x não aceita3.x aceita
  • N8N_MEMORY_GUARD_ENABLED
    • Nova na 3.x
    • Fora da documentação

    Experimental, novo na 3.x. Protege a instância contra falta de memória, só no modo regular. Com a memória alta, novas execuções de produção esperam e o n8n interrompe a execução que ocupa mais memória, com os sub-workflows dela. Se o mesmo workflow for interrompido várias vezes, o n8n despublica o workflow e avisa o responsável por email.

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

    Experimental. Fração do limite de memória, de 0 a 1, a partir da qual novas execuções de produção passam a esperar. Precisa ficar entre o nível de retomada e o de interrupção.

    Tipo
    Number
    Padrão
    0.8
    Versões
    1.x não aceita2.x não aceita3.x aceita
  • N8N_MEMORY_GUARD_RESUME_LEVEL
    • Nova na 3.x
    • Fora da documentação

    Experimental. Fração do limite de memória, de 0 a 1, abaixo da qual as execuções em espera voltam a rodar. Precisa ficar abaixo do nível de espera.

    Tipo
    Number
    Padrão
    0.75
    Versões
    1.x não aceita2.x não aceita3.x aceita
  • N8N_MEMORY_GUARD_STOPS_TO_UNPUBLISH
    • Nova na 3.x
    • Fora da documentação

    Experimental. Quantidade de interrupções do mesmo workflow de produção até o n8n despublicar o workflow. Com 0, a despublicação automática fica desligada.

    Tipo
    Number
    Padrão
    3
    Versões
    1.x não aceita2.x não aceita3.x aceita
  • N8N_MEMORY_GUARD_STOP_LEVEL
    • Nova na 3.x
    • Fora da documentação

    Experimental. Fração do limite de memória, de 0 a 1, a partir da qual o n8n interrompe a execução que ocupa mais memória. Precisa ficar entre o nível de espera e o crítico.

    Tipo
    Number
    Padrão
    0.85
    Versões
    1.x não aceita2.x não aceita3.x aceita
  • Desativa automaticamente o workflow quando todas as últimas execuções terminam em falha grave.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade de últimas execuções conferidas antes de desativar automaticamente um workflow.

    Tipo
    Number
    Padrão
    3
    Versões
    1.x aceita2.x aceita3.x aceita