🚀Guia de Instalação Whazing (Ubuntu 22)

🔹 Antes de começar

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

   • Frontend → whazing.seusite.com.br

   • Backend → backend.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.

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

---

🔹 Requisitos mínimos

• Ubuntu 22 (instalação limpa)

• 8 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

Use opção 1 e siga as 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