🚀Instalação

🔹 Antes de começar

1. Crie dois subdomínios e aponte-os para o IP da sua VPS:

   • Frontend → bot.seusite.com.br

   • Backend → api.seusite.com.br

2. Verifique a propagação do domínio em dnschecker.org.

   • Se usar Cloudflare, desative o proxy (nuvem laranja).

   • O IP da sua VPS deve aparecer em todas as validações.

*bot e api sugestão podes colocar endereço que achar melhor

⚠️ Só continue quando os subdomínios estiverem resolvendo corretamente.

---

🔹 Requisitos mínimos

• Ubuntu 22 (instalação limpa)

• 4 GB de memória RAM

• 2 subdomínios configurados (frontend e backend)

---

🔹 Instalação Automática (Recomendada)

1. Acessar como root

sudo su -

2. Instalar dependências iniciais

apt install software-properties-common

3. Atualizar pacotes

apt -y update

apt -y upgrade

4. Reiniciar a VPS

reboot

5. Instalador Whazing automaticamente

curl -sSL instalar.whazing.com.br | sudo bash

Caso passo 5 apresentar erro baixar instalador manualmente

1 - acessar pasta root

cd /root/

2 - baixar git

apt install git

3 - baixar instalador

git clone https://github.com/cleitonme/Whazing-SaaS.instalador.git whazinginstalador

4 - Da permisão

sudo chmod +x ./whazinginstalador/whazing

5 - Acessar pasta

cd ./whazinginstalador

6 - Executar

./whazing

A opção 1 que faz instalação so seguir instruções da tela

---

🔹 Instalação Manual via Docker

1. Atualizar pacotes

sudo apt update

sudo apt upgrade -y

2. Reiniciar a VPS

sudo reboot

3. Instalar pacotes básicos

sudo apt-get install -y ca-certificates

sudo apt-get install -y curl

sudo apt-get install -y unzip

4. Configurar repositório Docker

sudo install -m 0755 -d /etc/apt/keyrings

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

sudo chmod a+r /etc/apt/keyrings/docker.asc

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update

5. Instalar Docker e Docker Compose

sudo apt install -y docker-ce

sudo apt install -y docker-ce-cli

sudo apt install -y containerd.io

sudo apt install -y docker-buildx-plugin

sudo apt install -y docker-compose-plugin

6. Criar usuário deploy

adduser deploy

usermod -aG sudo deploy

usermod -aG docker deploy

su deploy

7. Baixar projeto Whazing

mkdir -p /home/deploy/whazing

cd /home/deploy

wget https://github.com/cleitonme/Whazing-SaaS/raw/refs/heads/main/docs/Instalacao_manual_docker/whazing.zip

unzip whazing.zip

sudo chown deploy.deploy /home/deploy/whazing/ -Rf

cd whazing

chmod 600 traefik/acme.json

8. Configurar variáveis de ambiente

• Edite os arquivos:

  • backend/.env

  • frontend/.env

  • docker-compose.yaml

⚙️ Ajuste os valores: domínios, senha padrão (sua_senha_segura) e timezone (America/Sao_Paulo).

9. Subir os serviços

docker compose up -d

---

🔄 Atualizações

Atualizar para versão estável

docker pull whazing/whazing-backend:latest

docker pull whazing/whazing-frontend:latest

docker compose up -d --no-deps --build backend

docker compose up -d --no-deps --build frontend

Migrar para versão Beta

Edite docker-compose.yaml e troque as imagens:

image: whazing/whazing-backend:beta

image: whazing/whazing-frontend:beta

Recriar containers:

docker compose up -d backend frontend

Atualizar versão Beta

docker pull whazing/whazing-backend:beta

docker pull whazing/whazing-frontend:beta

docker compose up -d --no-deps --build backend

docker compose up -d --no-deps --build frontend

---

🧹 Manutenção

Limpar imagens antigas e não usadas

docker system prune -a