Variáveis de ambiente: Queue mode e escala
40 variáveis das versões 1.123.92, 2.45.7 e 3.0.1
Queue mode com Redis e Bull, workers e pools de workers, configuração multi-main e recuperação da fila. 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.
Quantidade de jobs concluídos mantidos no Redis pelo Bull. Com
0, o padrão, o job sai assim que termina.Quantidade de jobs com falha mantidos no Redis pelo Bull. Com
0, o padrão, o job sai assim que falha.Quantidade de execuções conferidas em cada lote da recuperação da fila.
Intervalo em minutos entre as conferências de recuperação da fila.
Intervalo em segundos entre as checagens de liderança no multi-main.
Liga o multi-main no queue mode, com mais de um processo principal. Exige licença Enterprise.
Validade em segundos da chave de liderança no multi-main. O líder precisa renovar a chave antes desse prazo.
No queue mode, faz o worker gravar no armazenamento de binary data as respostas de webhook maiores que
N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX, para o processo principal transmitir ao cliente. Exige um modo de binary data com armazenamento compartilhado entre as instâncias.Tamanho máximo em MiB da resposta de webhook que o worker devolve ao processo principal pela fila, no queue mode. O Redis guarda algumas cópias da resposta durante o trajeto, por isso reserve cerca de 1,5 vez esse valor de memória no Redis para cada resposta em trânsito.
Experimental. Liga os pools de workers, que separam execuções em filas diferentes. Desligado, todas as execuções vão para a fila padrão.
Nome do pool deste worker. Vazio, o worker atende a fila
jobs. Com um nome, atende a filajobs-<nome>. Só vale em workers.Endereço IP que o servidor HTTP do worker escuta. Use
::para todas as interfaces.Faz o worker que recebe o sinal de desligamento suspender as execuções de produção no próximo Node. As execuções ficam em espera e continuam em outro worker. Execuções que ainda devem resposta a um webhook não são suspensas.
No queue mode da 1.x e da 2.x, com
true, levava as execuções manuais para os workers. Na 3.x, o queue mode envia as execuções manuais aos workers. A variável foi removida.Na 3.x, o n8n pede para remover a variável. Revise a memória dos workers, que passam a atender também as execuções manuais.
Prefixo das chaves do Bull no Redis, como em
bull:jobs:23.Endereços iniciais de um cluster Redis, no formato
host:porta, separados por vírgula.Número do banco do Redis usado pela fila.
Como o n8n resolve o hostname do Redis na primeira conexão:
LOOKUPusa o DNS do sistema eNONEpassa o hostname direto ao cliente Redis. UseNONEem clusters como o AWS ElastiCache com TLS, que falham com a resolução prévia.Resolve o hostname do Redis em IPv4 e IPv6.
Host do Redis usado pela fila.
Liga o keepalive TCP nas conexões com o Redis.
Espera inicial em milissegundos do keepalive TCP com o Redis.
Intervalo em milissegundos entre os testes de keepalive TCP com o Redis.
Senha do Redis.
Porta do Redis.
Reconecta ao Redis quando ele responde com erro
READONLY, típico de uma troca de servidor primário.Intervalo em milissegundos entre as atualizações automáticas dos slots do cluster Redis.
Tempo limite em milissegundos para atualizar os slots do cluster Redis.
Tempo total em milissegundos de novas tentativas de conexão com o Redis antes de o processo encerrar.
Liga TLS nas conexões com o Redis.
Nome do servidor enviado na extensão SNI do TLS ao conectar no Redis.
Valida o certificado do Redis quando o TLS está ligado. Desligue só em testes locais ou com certificado autoassinado.
Usuário do Redis. Exige Redis 6.0 ou superior.
Liga os endpoints de saúde do worker. O
/healthzindica se o processo está vivo. O/healthz/readinessindica se banco e Redis estão prontos.Porta do servidor HTTP de health check do worker.
Duração em milissegundos da reserva de um job pelo worker que o processa.
Intervalo em milissegundos para o worker renovar a reserva do job.
Quantidade de vezes que um job travado era reprocessado. Só existe na 1.x.
Intervalo em milissegundos entre as checagens de jobs travados. Com
0, a checagem fica desligada.Tempo em segundos que o worker esperava as execuções terminarem antes de encerrar. Defasada: use
N8N_GRACEFUL_SHUTDOWN_TIMEOUT.