Erro “Out of Memory” no n8n rodando em VPS: como resolver
Por Rodrigo Mendes de Oliveira — Fundador do Ecossistema MR
Se o seu agente de n8n começou a travar, reiniciar sozinho ou os logs mostram “JavaScript heap out of memory”, o problema quase sempre é o mesmo: o VPS não tem RAM suficiente para o volume de workflows rodando ao mesmo tempo. Veja como diagnosticar e resolver.
Passo 1: Confirmar que é mesmo falta de memória
Acesse o servidor via SSH e rode:
free -h
docker stats --no-streamSe o uso de memória estiver constantemente acima de 85-90%, ou se o container do n8n aparecer com uso de memória igual ao limite definido, esse é o problema.
Passo 2: Soluções rápidas (sem trocar de plano)
- Reduza o número de execuções simultâneas nas configurações do n8n (variável
N8N_CONCURRENCY_PRODUCTION_LIMIT) - Ative o modo de execução em fila (queue mode) com Redis, para processar workflows um de cada vez em vez de todos ao mesmo tempo
- Configure um limite de memória no container Docker (
mem_limit) para evitar que ele consuma tudo e derrube o servidor inteiro - Adicione um arquivo de swap temporário, como paliativo — não resolve definitivamente, mas evita quedas enquanto você planeja o upgrade
Como criar um swap de 2GB rapidamente:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfileQuando o problema é mesmo o plano
Se mesmo com essas otimizações o servidor continua no limite, isso significa que o volume do seu projeto já passou do que o plano atual suporta — hora de migrar para um VPS com mais RAM. Veja nosso guia de escolha de plano de VPS para saber exatamente quanto contratar.
Se você ainda está configurando o agente do zero, vale revisar o guia completo de como hospedar um agente de IA em n8n antes de ajustar essas configurações avançadas.
Rodrigo Mendes de Oliveira
Mais de 14 anos de experiência em SEO, formado em Sistemas de Informação (UNINOVE) e especialista em IA pelo MIT. Fundador da MR Tecnologia e vencedor do Silicon Valley Startup Award 2023 (StartSE).