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

1. Servidor limpo (zerado)
   O SetupOrion verifica se já existe painel/stack instalada e vai falhar se o servidor não estiver “limpo”.
2. 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.