Como Hospedar Evolution API em VPS: Tutorial com Docker
Como hospedar Evolution API em VPS
Tutorial completo de instalação e configuração da Evolution API com Docker
K2Host Blog · k2host.com.br/
A Evolution API é uma das ferramentas mais usadas para automação de WhatsApp no Brasil. Hospedar ela em uma VPS própria garante controle total, sem limites de mensagens e com seus dados seguros. Neste guia, você vai aprender a instalar a Evolution API em VPS do zero, usando Docker.
1. Pré-requisitos para sua Evolution API em VPS
- VPS com Ubuntu 22.04 LTS e acesso root
- Docker e Docker Compose instalados
- Domínio ou IP público fixo
- Nginx instalado (para proxy reverso)
- Certificado SSL (Let’s Encrypt)
Uma VPS com Docker com 2-4 GB de RAM é suficiente para a Evolution API. Se você for rodar junto com N8N, prefira 4 GB ou mais.
2. Instalação do Docker (se ainda não tiver)
Comece instalando o Docker, que será a base para rodar sua Evolution API em VPS:
apt update && apt install -y docker.io docker-compose-v2
systemctl enable –now docker
3. Criando o arquivo docker-compose.yml
Crie um diretório para a Evolution API:
mkdir -p /opt/evolution && cd /opt/evolution
Crie o arquivo docker-compose.yml com as configurações básicas. Configure as variáveis de ambiente:
AUTHENTICATION_API_KEY: uma chave secreta para autenticar chamadas à API
DATABASE_CONNECTION_URI: URL de conexão com o banco de dados (PostgreSQL recomendado)
SERVER_URL: URL pública onde a Evolution API estará acessível
WEBHOOK_GLOBAL_URL: webhook padrão para onde as mensagens serão enviadas
4. Configurando o banco de dados da Evolution API em VPS
A Evolution API suporta PostgreSQL como banco de dados principal. Adicione um serviço de PostgreSQL no docker-compose.yml ou use um banco já existente na VPS. Configure a connection string corretamente no arquivo de ambiente.
5. Configurando Nginx como proxy reverso
Crie um arquivo de configuração em /etc/nginx/sites-available/evolution:
server {
listen 80;
server_name api.seudominio.com.br;
location / {
proxy_pass http://localhost:8080;
proxy_set_header Host $host;
}
}
Ative a configuração e obtenha o SSL com o Certbot (Let’s Encrypt):
ln -s /etc/nginx/sites-available/evolution /etc/nginx/sites-enabled/
certbot –nginx -d api.seudominio.com.br
6. Subindo a Evolution API em VPS
cd /opt/evolution && docker compose up -d
Aguarde o container iniciar e acesse a URL configurada. Você verá a documentação da API (Swagger) se tudo estiver correto.
7. Criando a primeira instância e conectando o WhatsApp
- Faça uma requisição POST para /instance/create com o nome da instância.
- Faça GET para /instance/connect/{nome} para obter o QR Code.
- Escaneie o QR Code com o WhatsApp do número que deseja conectar.
- Configure o webhook para receber mensagens: POST para /webhook/set/{nome}.
Configure o webhook apontando para o N8N. Assim, cada mensagem recebida no WhatsApp dispara automaticamente um workflow no N8N. Pronto — sua Evolution API em VPS já está enviando e recebendo mensagens do WhatsApp automaticamente.
8. Manutenção da sua Evolution API em VPS
- Atualizar: docker compose pull && docker compose up -d
- Ver logs: docker compose logs -f evolution_api
- Backup: export do banco de dados PostgreSQL (automático na K2Host)
A K2Host oferece VPS com Docker suportado, backup automático incluso e suporte humanizado em português para ajudar na configuração.