Como instalar na VPS

Instale o sistema de gerenciamento de clientes Nexus na VPS do contratante (SSH), não no seu PC. O instalador baixa imagens Docker de ghcr.io/nexuswebs, configura Traefik, PostgreSQL e gera credenciais master.

Requisitos mínimos

1. Preparar a VPS

Contrate uma VPS (Hostinger, Hetzner, DigitalOcean, Contabo, etc.). Crie um registro DNS tipo A apontando app.suaempresa.com.br para o IP da VPS. Acesse via SSH como root.

2. Executar o instalador

Um único comando instala tudo: Docker, Traefik, PostgreSQL, Redis, Backend e Frontend. O menu interativo guia a configuração.

bash <(curl -fsSL https://raw.githubusercontent.com/nexuswebs/nexus-byo/main/setup.sh)

Escolha a opção 2 no menu. O instalador vai:

  • Instalar Docker automaticamente (se necessário)
  • Pedir domínio, nome do app e e-mail/senha do admin master
  • Gerar senhas do banco e JWT automaticamente
  • Oferecer trial gratuito de 7 dias ou ativação de licença
  • Baixar imagens, subir todos os serviços e verificar o health check

3. Login master (admin da plataforma)

Acesse https://seu-domínio/login com o e-mail e senha master definidos na instalação. As credenciais também ficam em /root/nexus-byo/CREDENCIAIS-MASTER.txt.

  • O usuário master administra a instalação (licença, empresas, branding global).
  • Ele não é o atendente do dia a dia — primeiro crie a empresa operacional.
  • Confirme a licença em Configurações → Licença BYO (válida, domínio e plano).

4. Criar a empresa (tenant)

No painel master: Empresas → Nova empresa.

  • Escolha o ramo (atendimento genérico, clínica/serviços, streaming/IPTV, etc.).
  • Defina nome, e-mail do admin da empresa e senha inicial.
  • Faça logout do master e entre com o login da empresa para operar inbox, CRM e equipe.

5. Uso próprio × revenda (quantas empresas)

  • Uso próprio (tier own): a licença deixa criar somente 1 empresa. Ideal para sua operação.
  • Revenda (tier resale): permite criar 2 ou mais empresas (ilimitadas), cada uma com login, branding e canais próprios — white-label.
  • O limite é da licença NXS2, não do instalador. Trocar de plano = renovar/ativar a licença correta.

6. Conectar WhatsApp na empresa

Com login da empresa: Canais WhatsApp (ou Integrações) → adicionar canal. Escolha um provedor abaixo.

APIs WhatsApp no BYO

Na VPS, você configura as credenciais do seu provedor. O Nexus Cloud/Vollio não compartilha o Tech Provider Meta da instalação hospedada — cada BYO usa o app/conta dele.

API oficial Meta

Crie um app no Meta for Developers (WhatsApp Cloud API), gere token, Phone Number ID e Business Account ID. No Nexus, provedor whatsapp_official — cole token, IDs e configure o webhook apontando para https://seu-domínio/webhook/... (conforme a tela do canal). Embedded Signup / Tech Provider da Vollio é para o Cloud; no BYO use seu próprio app Meta (ou modo manual com token).

UazAPI

Provedor não-oficial (conexão via QR/sessão). No canal, escolha uazapi, informe a URL da instância, token e API key. Ideal para começar rápido sem aprovação Meta. Atenção às políticas do WhatsApp (risco de ban).

Evolution API

Mesma lógica: instale/contrate Evolution, escolha provedor evolution no canal e preencha URL + chave da API. Também é conexão não-oficial (QR). Bom para quem já opera Evolution em outra stack.

Depois do canal online: configure IA, templates de cobrança e convide a equipe em Equipe. Teste enviando uma mensagem no inbox.

Menu do instalador

O mesmo comando abre um menu com todas as opções de gerenciamento: 

[1] Instalar Docker + dependências
[2] Instalar Nexus Atendimento   ← instalação completa
[3] Instalar Portainer (painel Docker)
[4] Atualizar Nexus Atendimento
[5] Verificar status dos serviços
[6] Ativar / Renovar licença BYO
[7] Informações e requisitos
[8] Desinstalar
[0] Sair
Troubleshooting: após a instalação, use a opção 5 para verificar se todos os serviços estão rodando. Se o health check falhar, verifique se o DNS está apontando corretamente e se as portas 80/443 estão abertas.

Atualizar: use a opção 4 para baixar novas imagens e reiniciar os serviços. Consulte o guia completo em byo-upgrade.html (backup, tags GHCR e rollback). Desinstalar: opção 8 permite remover com ou sem apagar dados.
Ver planos e preços Ativar licença NXS2