Solução de problemas
O instalador diz que a porta 80 ou 443 está em uso
Seção intitulada “O instalador diz que a porta 80 ou 443 está em uso”Outro programa (Apache, Nginx, outro painel) está usando a porta. Pare-o ou instale o Depanel numa máquina limpa.
Para ver quem usa: sudo ss -ltnp | grep -E ':(80|443) '.
O painel não abre depois de instalar
Seção intitulada “O painel não abre depois de instalar”- Confira se os contêineres estão de pé:
cd /opt/depanel && docker compose ps. - Veja os logs da API:
docker compose logs api --tail 100. - Se usou domínio próprio, confira se o registro A aponta para o IP do servidor.
O domínio fica em “Aguardando DNS”
Seção intitulada “O domínio fica em “Aguardando DNS””O registro ainda não aponta para a máquina certa, ou a mudança de DNS ainda não se espalhou (pode levar de minutos a
algumas horas). Confira com dig +short loja.suaempresa.com.br: o resultado deve ser o IP da máquina.
O domínio fica em “Aguardando HTTPS”
Seção intitulada “O domínio fica em “Aguardando HTTPS””O Let’s Encrypt precisa acessar a porta 80 da máquina. Confira o firewall do provedor e se não há proxy (como o da Cloudflare, nuvem laranja) bloqueando o desafio. Com Cloudflare, deixe o registro em “somente DNS” até o certificado sair.
A implantação falhou
Seção intitulada “A implantação falhou”Abra a implantação em Implantações: o log mostra o passo que falhou. Os mais comuns:
- build: erro de compilação do app — o mesmo erro aparece se você rodar o build no seu computador;
- verificação de saúde: o app não respondeu na porta informada — confira a porta e o comando de início;
- imagem não encontrada: nome ou versão da imagem errados, ou registro privado sem login.
A máquina aparece “fora do ar”
Seção intitulada “A máquina aparece “fora do ar””O agente parou de responder. No servidor: systemctl status depanel-agente e journalctl -u depanel-agente -n 50.
O agente reconecta sozinho quando a rede volta.
A atualização não foi aplicada
Seção intitulada “A atualização não foi aplicada”O painel continua na versão antiga e nada mudou. Em geral a imagem nova não pôde ser baixada (internet do servidor ou
registro fora do ar). Veja o motivo com docker logs depanel-atualizador e tente de novo mais tarde.