Solução de problemas
Problemas comuns do Coolify e como resolver
Os erros que mais aparecem no Coolify, agrupados por aplicação, domínio e SSL, servidor e painel, com a causa provável e o que fazer.
- Nível: Intermediário
- Tempo: depende do sintoma
- Atualizado em 12/11/2026
- Por equipe técnica da Hospedagem Segura
Conteúdo do guia
Resposta rápida
No Coolify, o 502 e o No Available Server quase sempre são porta errada ou aplicação escutando só em 127.0.0.1: confira Ports Exposes, faça a aplicação escutar em 0.0.0.0 e clique em Redeploy. O excesso de redirecionamentos vem da Cloudflare no modo Flexible. O SSL que não emite depende da porta 80 aberta e do DNS certo. Se o painel sumir, teste http://IP:8000 e rode docker restart coolify na VPS.
O painel do Coolify é em inglês. Neste manual, os botões aparecem como estão na tela, em negrito, com a tradução ao lado. Dúvida com algum termo? Veja o glossário do Coolify em português.
Você vai aprender
- O que querem dizer os erros 502, 503 e 504 no Coolify
- Resolver o laço de redirecionamento e o SSL que não emite
- Liberar disco sem perder os pontos de rollback
- Trazer o painel de volta quando ele não abre
Antes de começar
- Acesso ao painel do Coolify ou, se ele não abrir, acesso root à VPS por SSH
Procure o sintoma e siga o que fazer. Antes de mexer em qualquer coisa, abra os Logs (registros) da aplicação: a mensagem de erro costuma estar ali.
Os logs mostram o que a aplicação escreve enquanto roda.
Aplicação fora do ar
502 Bad Gateway
O que é: o proxy achou a aplicação, mas ela não respondeu. Causa provável: a porta em Ports Exposes não é a da aplicação, ela escuta só em 127.0.0.1 ou o contêiner está unhealthy (sem saúde). O que fazer: acerte a porta, faça a aplicação escutar em 0.0.0.0 e clique em Redeploy.
No Available Server (503)
O que é: o proxy não tem nenhum contêiner saudável para o domínio. Causa provável: o health check falha (imagem sem curl ou wget, porta errada no teste), a porta não bate, falta o domínio com ou sem www em Domains ou o modo de manutenção está ligado. O que fazer: corrija a porta e o health check, cadastre as duas formas do domínio e faça Redeploy. Se o log do proxy mostrar client version 1.24 is too old, atualize o Traefik.
504 Gateway Timeout
O que é: a aplicação não respondeu a tempo. Causa provável: ela está numa rede Docker que o proxy não alcança, comum em Docker Compose com rede própria, ou uma operação longa, como enviar um arquivo grande, passou do limite. O que fazer: deixe o serviço do domínio na rede do proxy e mande as operações longas para segundo plano.
Deploy de repositório privado falha
Causa provável: o repositório privado foi cadastrado como público, a deploy key usa o endereço HTTPS em vez do SSH (git@github.com:...) ou a chave pública não está no repositório. O que fazer: siga repositório privado no Coolify.
Domínio e SSL
- 1DNS mismatch o DNS do domínio não aponta para esta VPS.
- 2Redirect HTTP to HTTPS manda quem chega por HTTP para o HTTPS.
- 3Redirect type Temporary (temporário) ou Permanent (permanente).
DNS mismatch
O que é: o domínio não aponta para o IP da VPS, ou o DNS ainda não propagou. O que fazer: crie o registro A com o IPv4 da VPS e, se usar IPv6, o AAAA com o IPv6 dela. Com o proxy da Cloudflare ligado, o aviso pode aparecer mesmo com o site no ar.
dig +short A loja.example.com
dig +short AAAA loja.example.comToo many redirects (redirecionamento em laço)
Causa provável: a Cloudflare no modo SSL Flexible: ela fala HTTP com a VPS, o Coolify manda para o HTTPS e o ciclo recomeça. O Cloudflare Tunnel em HTTP com Redirect HTTP to HTTPS ligado faz o mesmo. O que fazer: na Cloudflare, use Full ou Full (strict); com o Tunnel, desligue o redirecionamento no Coolify.
O SSL não emite
O certificado do Let's Encrypt é pedido pela porta 80. As causas mais comuns:
- Porta 80 ou 443 fechada no firewall.
- Registro AAAA apontando para outro servidor.
- Proxy da Cloudflare ligado: desligue até o certificado sair ou use o desafio por DNS.
- Muitos pedidos seguidos (erro 429): espere o limite passar.
Corrigida a causa, a solução oficial é tirar o arquivo de certificados do proxy e clicar em Restart Proxy (reiniciar o proxy), em Servers > Proxy.
O acme.json guarda todos os certificados
mv /data/coolify/proxy/acme.json /data/coolify/proxy/acme.json.antigo- 1Running o proxy está rodando.
- 2Restart Proxy reinicia o proxy, que pede os certificados que faltam.
Servidor
O servidor cai durante o build
O que é: o build disputa CPU e memória com as aplicações, e a VPS trava. O que fazer: acompanhe com htop durante o deploy. Monte a imagem fora, numa esteira de CI, e publique com Docker Image, ou passe para um plano maior, como o de 8 GB (4 vCPU, 100 GB NVMe).
Disco cheio
O que é: os deploys falham e chega o aviso Disk usage warning. Causa provável: imagens antigas, restos de build, backups locais (em /data/coolify/backups) e logs. O que fazer: veja o que ocupa espaço e use Run Cleanup, em Servers > Docker cleanup.
df -h /
docker system dfdocker system prune -a e a opção --volumes: o primeiro apaga os pontos de rollback, e a segunda pode apagar volumes com dados.Painel
O painel não abre
Teste http://203.0.113.10:8000, com o IP da sua VPS (se você fechou a 8000, abra de novo para o teste). Se abre pelo IP e não pelo domínio, confira o DNS e o proxy: parado, ele volta com Start Proxy. Se nada abre, entre por SSH e veja os contêineres do Coolify.
docker ps --filter name=coolify
docker restart coolifySetup window closed no cadastro
O que é: o Coolify aceita a primeira conta só nos 10 minutos depois de iniciar. O que fazer: rode docker restart coolify, recarregue a página e cadastre o administrador logo.
Quando abrir um chamado
Mande junto o nome da aplicação, o domínio, a hora do erro e as últimas linhas do log.
Como saber se deu certo
A aplicação responde no domínio com HTTPS, o domínio sai de DNS mismatch e o painel volta a abrir.
Problemas comuns
O domínio mostra 404 page not found
- Causa provável
- O domínio não está em Domains da aplicação, ou todos os contêineres dela estão unhealthy.
- O que fazer
- Cadastre o domínio e faça Redeploy. Se ele já está lá, confira o health check e os logs.
O rollback não mostra a versão antiga
- Causa provável
- A limpeza do Docker apagou a imagem da versão antiga.
- O que fazer
- Mantenha Keep retained images na limpeza. Veja deploy automático e rollback.
Não resolveu? Veja os problemas comuns do Coolify ou abra um chamado na central do cliente.
Fontes e documentação oficial
- Coolify: erro 502 Bad Gateway
- Coolify: No Available Server
- Coolify: Let's Encrypt não funciona
- Coolify: painel inacessível
Coolify é um software de código aberto mantido pelo próprio projeto. Este manual é da Hospedagem Segura, para quem roda o Coolify nas nossas VPS, e foi conferido na versão 4.7.5.
Continue aprendendo
- Publicar aplicaçõesComo ligar um domínio com SSL a uma aplicação no CoolifyDo registro DNS ao site em HTTPS: Add Domain, o aviso DNS mismatch, a remoção do endereço provisório, os redirecionamentos e o Redeploy.Iniciante
- Administração e segurançaComo atualizar e manter o CoolifyBackup antes, atualização pelo painel ou pelo upgrade.sh, limpeza do Docker, o proxy, a conexão com o servidor e uma segunda VPS quando a primeira ficar pequena.Intermediário
- Operação do dia a diaLogs, terminal e monitoramento no CoolifyAs ferramentas para entender o que a aplicação está fazendo: logs, terminal web, healthcheck, limites de CPU e memória e métricas.Intermediário
Rode o Coolify numa VPS da Hospedagem Segura
VPS Linux com acesso root, disco NVMe e IPv4 dedicado a partir de R$ 69,90/mês. Prefere a VPS pronta? No VPS Assistido, o Coolify vem instalado, com o painel no seu domínio, e a equipe ajuda no dia a dia.