Ir para o conteúdo
Promovaweb

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.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade de jobs com falha mantidos no Redis pelo Bull. Com 0, o padrão, o job sai assim que falha.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade de execuções conferidas em cada lote da recuperação da fila.

    Tipo
    Number
    Padrão
    100
    Versões
    1.x aceita2.x aceita3.x aceita
  • Intervalo em minutos entre as conferências de recuperação da fila.

    Tipo
    Number
    Padrão
    180
    Versões
    1.x aceita2.x aceita3.x aceita
  • Intervalo em segundos entre as checagens de liderança no multi-main.

    Tipo
    Number
    Padrão
    3
    Versões
    1.x aceita2.x aceita3.x aceita
  • Liga o multi-main no queue mode, com mais de um processo principal. Exige licença Enterprise.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Validade em segundos da chave de liderança no multi-main. O líder precisa renovar a chave antes desse prazo.

    Tipo
    Number
    Padrão
    10
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

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

    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.

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

    Nome do pool deste worker. Vazio, o worker atende a fila jobs. Com um nome, atende a fila jobs-<nome>. Só vale em workers.

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

    Endereço IP que o servidor HTTP do worker escuta. Use :: para todas as interfaces.

    Tipo
    String
    Padrão
    ::
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x não aceita
  • Prefixo das chaves do Bull no Redis, como em bull:jobs:23.

    Tipo
    String
    Padrão
    bull
    Versões
    1.x aceita2.x aceita3.x aceita
  • Endereços iniciais de um cluster Redis, no formato host:porta, separados por vírgula.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Número do banco do Redis usado pela fila.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x aceita2.x aceita3.x aceita
  • Como o n8n resolve o hostname do Redis na primeira conexão: LOOKUP usa o DNS do sistema e NONE passa o hostname direto ao cliente Redis. Use NONE em clusters como o AWS ElastiCache com TLS, que falham com a resolução prévia.

    Tipo
    Enum
    Padrão
    LOOKUP
    Versões
    1.x não aceita2.x aceita3.x aceita
    Valores
    • LOOKUP
    • NONE
  • Resolve o hostname do Redis em IPv4 e IPv6.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Host do Redis usado pela fila.

    Tipo
    String
    Padrão
    localhost
    Versões
    1.x aceita2.x aceita3.x aceita
  • QUEUE_BULL_REDIS_KEEP_ALIVE
    • Fora da documentação

    Liga o keepalive TCP nas conexões com o Redis.

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

    Espera inicial em milissegundos do keepalive TCP com o Redis.

    Tipo
    Number
    Padrão
    5000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Intervalo em milissegundos entre os testes de keepalive TCP com o Redis.

    Tipo
    Number
    Padrão
    5000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Senha do Redis.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Porta do Redis.

    Tipo
    Number
    Padrão
    6379
    Versões
    1.x aceita2.x aceita3.x aceita
  • Reconecta ao Redis quando ele responde com erro READONLY, típico de uma troca de servidor primário.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Intervalo em milissegundos entre as atualizações automáticas dos slots do cluster Redis.

    Tipo
    Number
    Padrão
    5000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo limite em milissegundos para atualizar os slots do cluster Redis.

    Tipo
    Number
    Padrão
    1000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo total em milissegundos de novas tentativas de conexão com o Redis antes de o processo encerrar.

    Tipo
    Number
    Padrão
    10000
    Versões
    1.x aceita2.x aceita3.x aceita
  • Liga TLS nas conexões com o Redis.

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

    Nome do servidor enviado na extensão SNI do TLS ao conectar no Redis.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Valida o certificado do Redis quando o TLS está ligado. Desligue só em testes locais ou com certificado autoassinado.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Usuário do Redis. Exige Redis 6.0 ou superior.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Liga os endpoints de saúde do worker. O /healthz indica se o processo está vivo. O /healthz/readiness indica se banco e Redis estão prontos.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Porta do servidor HTTP de health check do worker.

    Tipo
    Number
    Padrão
    5678
    Versões
    1.x aceita2.x aceita3.x aceita
  • Duração em milissegundos da reserva de um job pelo worker que o processa.

    Tipo
    Number
    Padrão
    60000
    Versões
    1.x aceita2.x aceita3.x aceita
  • Intervalo em milissegundos para o worker renovar a reserva do job.

    Tipo
    Number
    Padrão
    10000
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade de vezes que um job travado era reprocessado. Só existe na 1.x.

    Tipo
    Number
    Padrão
    1
    Versões
    1.x aceita2.x não aceita3.x não aceita
  • Intervalo em milissegundos entre as checagens de jobs travados. Com 0, a checagem fica desligada.

    Tipo
    Number
    Padrão
    30000
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tempo em segundos que o worker esperava as execuções terminarem antes de encerrar. Defasada: use N8N_GRACEFUL_SHUTDOWN_TIMEOUT.

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