Arquitetura

Como instalar Docker, Portainer e Evolution API

Este guia mostra como subir um ambiente completo com Docker, Portainer e Evolution API, utilizando o Orion Design (interface padrão da Evolution), de forma organizada e fácil de manter.

A ideia é ter:

containers gerenciáveis via Portainer
stack versionável via Docker Compose
Evolution API pronta para uso em produção

Pré-requisitos que evitam dor de cabeça

Servidor limpo (zerado)
O SetupOrion verifica se já existe painel/stack instalada e vai falhar se o servidor não estiver “limpo”.
Domínio e DNS
A recomendação do guia é criar um subdomínio base (ex.: vps.seudominio.com) apontando para o IP do servidor e, a partir dele, criar CNAMEs para as apps (portainer, api etc.).

Passo a passo: instalar Docker + Traefik + Portainer + Evolution API via SetupOrion

1) Prepare o DNS (antes de rodar o instalador)

Crie o registro base:

A: vps.seudominio.com → IP do seu servidor (proxy desligado, se usar Cloudflare)

Depois, crie os CNAMEs que você vai usar:

CNAME: portainer → vps.seudominio.com (proxy desligado)
CNAME: api → vps.seudominio.com (proxy desligado)

Se você não quiser usar vps.seudominio.com, pode apontar o CNAME direto para o IP, mas o modelo do “vps base” facilita troca de IP depois.

2) Conecte via SSH

Exemplo:

ssh root@SEU-IP

(ou ssh root@vps.seudominio.com)

3) Rode o SetupOrion (um comando)

bash <(curl -sSL setup.oriondesign.art.br)

Isso abre o menu do SetupOrion.

4) Instale Traefik + Portainer (primeiro)

No menu, a recomendação é começar pela opção de base Traefik + Portainer (no guia aparece como a “primeira instalação obrigatória”).

Durante o processo ele vai pedir:

hostname do Portainer (ex.: portainer.seudominio.com)
usuário e senha (o guia menciona evitar caracteres problemáticos e usar credenciais seguras)
e-mail (usado para SSL/certificados)

Ao final, você acessa o Portainer em:

https://portainer.seudominio.com

5) Instale a Evolution API pelo próprio menu do SetupOrion

Com o SetupOrion aberto, selecione a Evolution API.

“03 – Evolution API” → digite 03

Depois ele vai pedir o domínio da Evolution API:

informe: api.seudominio.com (garanta que o CNAME api já existe)

Ao final ele exibe algo como:

Server URL: https://api.seudominio.com
Global API Key: ... (salve isso)

6) Acesse o “manager” da Evolution API (Orion/gerenciador)

A URL indicada no guia:

https://api.seudominio.com/manager

Você entra com:

Server URL = https://api.seudominio.com
Global API Key = a chave exibida ao final da instalação

7) Verifique no Portainer se está tudo rodando

No Portainer:

Stacks → encontre a stack da Evolution API → status “Running”

O que esse método te entrega (sem gambiarra)

Docker instalado automaticamente
Traefik pronto (rotas + SSL)
Portainer pronto (gestão)
Evolution API instalada e acessível por domínio
Tudo via menu, no padrão do SetupOrion.

Leonardo