Ir para o conteúdo
Promovaweb

Variáveis de ambiente: Agendamento

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

Agendador da instância, com intervalos, tentativas, lotes e tolerância a disparos atrasados. Inclui os cursores duráveis dos Nodes de polling. 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.

  • N8N_ENV_FEAT_SKIP_DURABLE_SCHEDULER
    • Fora do código atual
    • Fora da documentação

    Controlava a opção Skip Durable Scheduler do Schedule Trigger, que deixou de existir.

    Na 2.x e na 3.x, o n8n pede para remover a variável. Para manter todos os agendamentos no agendador em memória com o serviço de publicação ligado, use N8N_SCHEDULER_ENABLED=false.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • Grava juntos, de forma atômica, o avanço do cursor de um trigger por polling e a execução gerada. Desligada, uma queda entre as duas gravações pode pular itens ou repetir uma execução. Exige o agendador durável com polling ligado.

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

    Faz o agendador durável executar as tarefas agendadas dos agentes, no lugar do timer interno. Exige o agendador durável ligado. Com várias instâncias, ligue só quando todas estiverem numa versão compatível.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade máxima de execuções agendadas que uma instância pega da fila em cada passada.

    Tipo
    Number
    Padrão
    100
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Liga o agendador durável, que grava as execuções agendadas no banco antes de rodar. Assim, um reinício não perde agendamentos e, com várias instâncias, cada execução roda uma vez. Com false, volta o agendador em memória.

    Na 2.x e na 3.x, com false, o n8n avisa que o agendador em memória está defasado e será removido junto da variável.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Intervalo em segundos para o agendador procurar execuções cujo horário chegou. É o atraso máximo entre o horário previsto e o início.

    Tipo
    Number
    Padrão
    5
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo limite em segundos de cada procura por execuções devidas, para que uma consulta travada no banco não segure o agendador.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo em segundos que as tarefas com falha ou perdidas ficam guardadas antes de apagar. O padrão equivale a 7 dias, mais que as concluídas, para dar tempo de investigar.

    Tipo
    Number
    Padrão
    604800
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Variação aleatória aplicada aos intervalos das checagens internas do agendador, como fração de cada intervalo. Com 0.1, uma checagem de 10 segundos roda entre 9 e 11 segundos.

    Tipo
    Number
    Padrão
    0.1
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo em segundos que uma instância reserva a execução que pegou, para nenhuma outra iniciar a mesma. Se a instância parar, a reserva expira e outra pode assumir.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Intervalo em segundos entre as varreduras que registram as próximas execuções dos agendamentos ativos.

    Tipo
    Number
    Padrão
    10
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo limite em segundos de cada varredura das próximas execuções.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Janela em segundos das próximas execuções que o agendador registra com antecedência no banco. Uma janela longa cobre quedas mais longas da instância e grava mais registros futuros.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade de vezes que uma execução agendada pode ser retomada ou repetida antes de ser descartada. Aumente em infraestrutura com reinícios frequentes.

    Tipo
    Number
    Padrão
    5
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade máxima de checagens do mesmo tipo rodando juntas numa instância, quando o banco permite, como no Postgres. Acima do limite, a checagem seguinte é pulada.

    Tipo
    Number
    Padrão
    10
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Atraso máximo em segundos para uma execução agendada ainda ser tratada como no horário. Acima disso, a execução é tratada como perdida. A política do agendamento decide se ela ainda roda. O máximo é 30 dias.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo em segundos que um agendamento sem dono fica desligado antes de ser apagado. O agendamento para de rodar na hora. O prazo só adia a exclusão.

    Tipo
    Number
    Padrão
    86400
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade de donos conferidos por consulta ao banco na checagem de agendamentos abandonados, entre 1 e 1000.

    Tipo
    Number
    Padrão
    500
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Confere de tempos em tempos se cada agendamento ainda tem dono e limpa os que sobraram de uma exclusão incompleta. Desligada, esses agendamentos ficam desativados sem serem removidos.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Intervalo em segundos entre as checagens de agendamentos abandonados. O padrão equivale a 15 minutos.

    Tipo
    Number
    Padrão
    900
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo limite em segundos de cada checagem de agendamentos abandonados.

    Tipo
    Number
    Padrão
    300
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo em segundos que um agendamento recém-criado fica fora da checagem de abandono, porque ele pode ser gravado um instante antes do dono.

    Tipo
    Number
    Padrão
    300
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo limite em segundos de cada consulta de um trigger por polling, como uma caixa de email ou uma API. Uma consulta abandonada não perde itens, porque a próxima cobre o mesmo intervalo.

    Tipo
    Number
    Padrão
    45
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Faz o agendador durável controlar os triggers por polling, no lugar do timer interno. Exige o agendador durável ligado.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade máxima de tarefas com reserva vencida recuperadas em cada varredura.

    Tipo
    Number
    Padrão
    100
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Intervalo em segundos para procurar execuções reservadas que não terminaram por queda ou desligamento da instância. O agendador libera essas execuções para outra instância.

    Tipo
    Number
    Padrão
    30
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo limite em segundos de cada varredura de recuperação.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo em segundos que as tarefas concluídas ou canceladas ficam guardadas antes de apagar. O padrão equivale a um dia.

    Tipo
    Number
    Padrão
    86400
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Intervalo em segundos entre as limpezas de tarefas antigas do agendador. O padrão equivale a uma hora.

    Tipo
    Number
    Padrão
    3600
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo limite em segundos de cada limpeza de tarefas antigas.

    Tipo
    Number
    Padrão
    300
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Faz o agendador durável controlar as tarefas internas de manutenção, como limpeza de execuções, compactação dos Insights e renovação da licença. Exige o agendador durável ligado.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo máximo em segundos de cada execução de uma tarefa agendada antes de o agendador sinalizar a interrupção. Um código que ignora o sinal continua rodando.

    Tipo
    Number
    Padrão
    300
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Como o agendador durável roda os intervalos de segundos e minutos do Schedule Trigger. legacy alinha os disparos ao relógio, como o agendador em memória. new, o padrão, espaça os disparos a partir da ativação.

    Na 2.x e na 3.x, o n8n avisa que o modo legacy está defasado e será removido junto da variável.

    Tipo
    Enum
    Padrão
    new
    Versões
    1.x não aceita2.x aceita3.x aceita
    Valores
    • legacy
    • new