🚨Sistema não abre

Se o sistema não abre, parou de funcionar ou apresenta erros, siga este guia passo a passo. A maioria dos problemas está relacionada a falta de espaço, DNS, containers parados ou atualização incompleta.


❓ Meu sistema não está funcionando. O que fazer primeiro?

1️⃣ Verifique se sua VPS tem espaço livre

Quando a VPS fica sem espaço, o sistema pode:

  • Não abrir

  • Parar de enviar mensagens

  • Travar o backend

  • Não salvar arquivos

🔍 Como verificar o espaço da VPS

No terminal da VPS, execute:

df -h

Esse comando mostra o uso do disco.

Exemplo de uso do disco

⚠️ Atenção ao campo Mounted on /

  • O valor mais importante é o da linha /

  • Se estiver acima de 80%, já é considerado crítico

  • No exemplo da imagem, o uso está em 82%, o que pode causar falhas no sistema


🛠️ Como resolver falta de espaço

✅ Opção 1: Aumentar o disco da VPS

Verifique com a empresa onde você contratou a VPS se é possível aumentar o espaço em disco.


✅ Opção 2: Apagar arquivos antigos (opção mais comum)

📂 Limpar arquivos de log (recomendado)

Os logs podem crescer muito com o tempo.

📁 Caminho da pasta de logs:

No terminal:

👉 Isso não apaga dados do sistema, apenas registros antigos.


📂 Limpar arquivos de mídia (imagens, vídeos, áudios)

📁 Pasta onde ficam os arquivos enviados:

Estrutura:

  • Pastas por ID da empresa (1, 2, 3...)

  • Dentro delas, pastas por data (exemplo: 202510)


🔎 Verificar quais pastas estão ocupando mais espaço

Entre na pasta desejada e execute:

Para mostrar apenas pastas acima de 1GB:

Pastas com alto consumo

🗑️ Apagar uma pasta específica

Exemplo: apagar a pasta 202510:

⚠️ Atenção: apague apenas pastas antigas que você tenha certeza que não precisa mais.


🔐 Erro: Backend não consegue logar

Se o sistema abre, mas não faz login ou apresenta erro no backend:

🔄 Reinicie os containers

Depois disso, aguarde alguns segundos e teste novamente.


🆕 Instalação nova e o sistema não abre

1️⃣ Verifique o DNS

⚠️ Se usar Cloudflare:

  • Não ative o proxy (nuvem laranja deve ficar desativada)

  • O IP da VPS deve aparecer em todas as regiões


2️⃣ Verifique os logs do sistema

Consulte a documentação: 👉 Acessando logs


3️⃣ Reinstale o sistema (último caso)

  • Formate a VPS

  • Utilize Ubuntu 22

  • Refaça toda a instalação conforme a documentação oficial


🔄 Acabei de atualizar e deu problema

1️⃣ Você fez snapshot / backup da VPS antes de atualizar?

  • Se sim, restaure o backup

2️⃣ Execute o atualizador novamente

  • Pode ter ocorrido erro durante o processo

3️⃣ Verifique os logs 👉 Acessando logs


⚡ O sistema parou de funcionar “do nada”

Siga esta ordem:

1️⃣ Reinicie a VPS 2️⃣ Verifique os logs 3️⃣ Execute a atualização 4️⃣ Verifique o DNS no https://dnschecker.orgarrow-up-right 5️⃣ Confirme se o SSL está funcionando corretamente 👉 Problemas com SSL


📵 Sistema não envia ou não recebe mensagens

1️⃣ Reinicie a VPS 2️⃣ Reconecte o WhatsApp no sistema 3️⃣ Verifique os logs

👉 Acessando logs


⚠️ Erro comum no log (Redis)

Se aparecer algo como:

👉 É necessário reinstalar o Redis Consulte a documentação: 🔗 Reinstalar Redis


🆘 Grupo de suporte

Se mesmo após seguir todos os passos o problema continuar:

👉 Acesse o grupo de suporte: 🔗 https://grupo.whazing.com.brarrow-up-right

Envie o máximo de informações possíveis:

  • Domínios utilizados

  • Resultado de comandos como ping

  • Logs do sistema 👉 Acessando logs

Atualizado