Instalar em infraestrutura Swarm + Traefik

import Aviso from ‘../../../components/Aviso.astro’

Use este caminho em vez de instalar em um comando quando a VPS já roda em modo Docker Swarm, já tem uma rede externa do Traefik e o deploy deve ser feito como mais uma stack entre várias outras — não como uma instalação dedicada com docker compose. Os dois caminhos são independentes: nenhuma decisão tomada aqui afeta uma instalação standalone no mesmo host.

Antes de começar

• Host já em modo Swarm (docker swarm init já rodado).
• Uma rede externa do Traefik já existente (por padrão info_net).
• DNS do domínio escolhido já apontando para o IP do host.
• Uma chave de licença (opcional na linha de comando — se omitida, é pedida interativamente, com a digitação escondida na tela).

O comando

ENCHAT_DOMAIN=crm.suaempresa.com ./instalar-swarm.sh <versão>

A versão é obrigatória e vem do portal da sua conta — nunca latest, o script recusa.

O que muda em relação à instalação padrão

	Padrão (instalar.sh)	Swarm (esta forma)
Como sobe	docker compose	docker stack deploy
Acesso ao painel	Porta exposta direto na VPS	Roteamento por domínio via Traefik, HTTPS automático
Painel de diagnóstico do WhatsApp não-oficial	Exposto em 127.0.0.1 na própria VPS	Não exposto por domínio nenhum — acesso só por dentro do host (docker exec ou um túnel)
Onde ficam os segredos	Um arquivo .env na pasta da instalação	Um arquivo com permissão restrita, num caminho fixo do host
Ativação	Conduzida pelo painel de instalação antes de tudo subir	Por CPF/WhatsApp dentro do próprio app, ou pela chave de licença informada no comando

O binário e o comportamento do EnchaT são exatamente os mesmos nos dois caminhos — a diferença é só como a instalação é orquestrada.

Rodar o comando de novo (por exemplo, para atualizar a versão) preserva os segredos já gerados — só a versão e o domínio são atualizados.

Sobre a licença desta instalação

Como qualquer instalação Grátis, esta fica vinculada a este servidor. Migrar para outro servidor exige contato com o suporte — veja Migrar para outro servidor. Gerar uma nova identidade de instalação por conta própria numa instalação já ativada derruba a licença vinculada; se isso for realmente necessário, o suporte precisa desvincular a licença antes, nunca depois.

Verificação rápida pós-instalação

docker service ls                                            # 3 serviços, réplicas 1/1
curl -sS https://SEU_DOMINIO/api/healthz                     # {"db":"ok","status":"ok"}

Se algo der errado

Veja A instalação não termina.