Como escalar o n8n em Queue Mode com Redis e múltiplos Workers

1. Arquitetura e pré-requisitos no ambiente

Quando sua instância do n8n passa de dezenas de execuções simultâneas ou processa webhooks de WhatsApp em horário de pico, o processo único em Node.js pode sofrer gargalo de CPU. O Queue Mode resolve isso dividindo o n8n em instância principal (editor/webhooks) e workers controlados pelo Redis.

• Plano recomendado: VPS Performance (12 GB RAM / 6 vCPUs) ou Ultra (20 GB RAM).
• Banco de dados obrigatório: PostgreSQL 15+ (SQLite não suporta múltiplos workers simultâneos).
• Instância Redis 7+ rodando na rede interna do Docker.
• Chave N8N_ENCRYPTION_KEY idêntica compartilhada entre o container principal e todos os workers.

2. Passo a passo de implementação e validação

1. Defina a variável N8N_ENCRYPTION_KEY no seu arquivo .env (copie a chave atual do seu ~/.n8n/config se já tiver credenciais salvas).
2. Adicione no serviço principal e nos workers: EXECUTIONS_MODE=queue, QUEUE_BULL_REDIS_HOST=redis e QUEUE_BULL_REDIS_PORT=6379.
3. No container worker, altere o comando de inicialização para n8n worker --concurrency=10.
4. Configure OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true para que até testes manuais no editor rodem nos workers.
5. Suba a stack com docker compose up -d e verifique nos logs do worker a mensagem n8n worker is now ready.

3. Boas práticas de produção, segurança e escala

No modo fila, se um worker reiniciar ou atingir pico de memória, o job permanece seguro no Redis e é reprocessado automaticamente.

• Ative EXECUTIONS_DATA_PRUNE=true e EXECUTIONS_DATA_MAX_AGE=168 (7 dias) para o PostgreSQL não inflar.
• Use nosso Storage S3 (N8N_DEFAULT_BINARY_DATA_MODE=s3) para que todos os workers acessem os mesmos arquivos binários.
• Monitore o consumo de RAM por worker com docker stats antes de elevar a concorrência acima de 15.