Instalando Evolution API: Tutorial Prático de Deploy — July 2026

Introdução ao Deploy da Evolution API em Produção

Se você chegou até aqui, já sabe que a Evolution API é a ferramenta self-hosted mais poderosa do mercado para conectar sistemas ao ecossistema do WhatsApp. No entanto, colocar essa solução para rodar com alta disponibilidade exige mais do que apenas um script solto; exige uma infraestrutura de WhatsApp API bem dimensionada e segura. Na minha experiência com mais de 500 projetos de infraestrutura na Host You Secure, vejo que o maior gargalo não é o código da ferramenta, mas sim a escolha incorreta do servidor e falhas na configuração inicial do Docker.

Neste artigo prático, vou mostrar exatamente como estruturar o ambiente, calcular os recursos de hardware necessários e executar o deploy completo da sua API de automação e chatbot sem dor de cabeça.

Requisitos de Servidor para Rodar a Evolution API

Quais são os requisitos mínimos de hardware para hospedar a Evolution API sem travamentos? Para ambientes de produção com volume moderado de mensagens, você precisa dimensionar corretamente CPU, memória RAM e armazenamento SSD.

Dimensionamento de Recursos (RAM, CPU e Disco)

A Evolution API consome recursos de forma dinâmica, principalmente devido ao ecossistema Node.js e instâncias do Baileys gerenciando conexões simultâneas via WebSocket. Em termos práticos de infraestrutura:

• CPU: Mínimo de 4 vCPUs dedicadas para processar requisições concorrentes e webhooks sem latência perceptível.
• Memória RAM: Pelo menos 4GB de RAM. Abaixo disso, o processo do Node.js corre sério risco de sofrer crash por estouro de memória (Out of Memory - OOM Killer) quando múltiplos disparos de mensagens ocorrerem.
• Armazenamento: 20GB de SSD NVMe são suficientes para o sistema operacional, logs da aplicação e persistência de dados do banco PostgreSQL/Redis.

Comparativo de Infraestrutura para Automação

Veja abaixo um comparativo claro entre diferentes abordagens de hospedagem para a sua ferramenta de WhatsApp API:

Tutorial Passo a Passo: Instalando a Evolution API via Docker

Como instalar a Evolution API passo a passo em um servidor Ubuntu recente? Siga este procedimento testado e validado em nossos ambientes de homologação.

1. Atualize o sistema operacional: Acesse seu VPS via SSH e execute os comandos de atualização:
   

   sudo apt update && sudo apt upgrade -y

2. Instale o Docker e o Docker Compose: Certifique-se de que o container engine está atualizado na sua máquina.
   

   sudo apt install docker.io docker-compose-v2 -y

3. Crie o diretório do projeto:
   

   mkdir -p /opt/evolution-api && cd /opt/evolution-api

4. Configure o arquivo docker-compose.yml: Crie um arquivo com as diretrizes dos serviços necessários (API, banco de dados Redis/Postgres se aplicável).
5. Inicie os containers: Execute o comando para subir a aplicação em background:
   

   sudo docker compose up -d

Erros Comuns na Configuração do Servidor

Quais são os erros mais frequentes que podem derrubar a sua aplicação e como evitá-los? O erro número um cometido por administradores iniciantes é esquecer de liberar as portas corretas no firewall do sistema operacional (UFW) ou do painel da VPS. Outro problema recorrente é a ausência de um proxy reverso com certificado SSL (como Nginx Proxy Manager ou Traefik), o que impede a comunicação segura via HTTPS/WSS, que é um requisito obrigatório para webhooks modernos funcionarem perfeitamente com qualquer chatbot avançado.

Além disso, nunca deixe a chave de autenticação padrão (Global API Key) exposta ou fraca. Recomendo gerar chaves criptografadas longas para proteger seu endpoint contra invasões e uso não autorizado.

Perguntas Relacionadas sobre Infraestrutura e API

Posso rodar múltiplos números de WhatsApp na mesma instância?

Sim, a arquitetura moderna da Evolution API suporta multi-atendimento e múltiplas instâncias simultâneas, desde que o seu servidor possua memória RAM suficiente para suportar o consumo de todas as sessões ativas.

O Redis é obrigatório para o funcionamento?

Embora seja possível rodar sem ele em cenários extremamente básicos, o uso do Redis é altamente recomendado para gerenciar filas de mensagens, cache e estado das instâncias com alta performance e sem perda de dados.

Como garantir backups automáticos dos dados da API?

Você deve configurar rotinas de backup utilizando cron jobs para compactar e enviar o diretório de dados dos containers e volumes Docker para um storage externo ou S3 de forma periódica.

Conclusão e Próximos Passos

Implementar a sua própria Evolution API em um ambiente controlado traz independência total de custos com plataformas de terceiros e liberdade para escalar suas estratégias de atendimento e marketing via WhatsApp API. Para colocar tudo isso em prática com máxima estabilidade, segurança e excelente custo-benefício, recomendamos fortemente o plano VPS Brasil Básico. Rodamos esse exato setup em uma VPS Brasil Básico (R$ 99/mês, 4GB RAM, 4 vCPUs), garantindo o poder de processamento ideal para o seu projeto decolar sem surpresas no final do mês. Visite nosso blog para mais tutoriais técnicos avançados sobre automação e infraestrutura cloud.