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.
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.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.
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.
Quantidade máxima de execuções agendadas que uma instância pega da fila em cada passada.
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.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.
Tempo limite em segundos de cada procura por execuções devidas, para que uma consulta travada no banco não segure o agendador.
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.
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.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.
Intervalo em segundos entre as varreduras que registram as próximas execuções dos agendamentos ativos.
Tempo limite em segundos de cada varredura das próximas execuções.
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.
Quantidade de vezes que uma execução agendada pode ser retomada ou repetida antes de ser descartada. Aumente em infraestrutura com reinícios frequentes.
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.
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.
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.
Quantidade de donos conferidos por consulta ao banco na checagem de agendamentos abandonados, entre 1 e 1000.
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.
Intervalo em segundos entre as checagens de agendamentos abandonados. O padrão equivale a 15 minutos.
Tempo limite em segundos de cada checagem de agendamentos abandonados.
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.
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.
Faz o agendador durável controlar os triggers por polling, no lugar do timer interno. Exige o agendador durável ligado.
Quantidade máxima de tarefas com reserva vencida recuperadas em cada varredura.
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.
Tempo limite em segundos de cada varredura de recuperação.
Tempo em segundos que as tarefas concluídas ou canceladas ficam guardadas antes de apagar. O padrão equivale a um dia.
Intervalo em segundos entre as limpezas de tarefas antigas do agendador. O padrão equivale a uma hora.
Tempo limite em segundos de cada limpeza de tarefas antigas.
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.
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.
Como o agendador durável roda os intervalos de segundos e minutos do Schedule Trigger.
legacyalinha 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
legacyestá defasado e será removido junto da variável.