Coolify com problemas: erros comuns, diagnóstico e soluções

Coolify facilita o deploy, mas a infraestrutura continua existindo

Se o Coolify parou, comece distinguindo o painel de uma aplicação isolada. A falha pode estar na VPS ou no Linux, em CPU, RAM ou disco, no Docker, container, aplicação, Traefik, porta, DNS, SSL, banco de dados, Cloudflare quando usada ou no deploy. O alcance do problema indica onde investigar primeiro.

O Coolify simplifica a publicação de sites, APIs, workers, bancos de dados e outros serviços em servidores próprios. Ele automatiza boa parte do build, da criação de containers, do roteamento e da emissão de certificados. Ainda assim, a aplicação continua dependendo de Linux, Docker, rede, DNS, armazenamento e recursos reais da VPS.

O diagnóstico começa pela camada mais ampla e avança até a aplicação. Essa ordem reduz tentativas aleatórias e ajuda a preservar logs importantes para descobrir o que realmente aconteceu.

Primeiro descubra o que realmente está fora do ar

Compare o painel e as aplicações antes de escolher uma hipótese. O mesmo erro visto no navegador pode ter origens diferentes.

O que verificar quando o Coolify está fora do ar

Primeiro, identifique o alcance: somente uma aplicação falhou, todos os domínios estão indisponíveis ou nem o painel abre? Se todas as aplicações e o painel pararam ao mesmo tempo, a investigação deve começar pela VPS, pelo Docker e pelo proxy. Se apenas um projeto falhou, concentre-se no deploy, no container e nas dependências desse recurso.

Muitos problemas do Coolify começam fora do Coolify

Coolify automatiza deploy e gerenciamento de aplicações, mas continua dependendo do servidor Linux, Docker, armazenamento, rede e recursos da VPS. Resolver um incidente pode exigir análise de toda a infraestrutura, além do painel.

1. 1.Linux / VPS
2. 2.Docker
3. 3.Coolify
4. 4.Traefik
5. 5.Aplicação
6. 6.Banco e serviços externos

Conhecer suporte para servidores Linux.

Aplicação reiniciando continuamente no Coolify

Quando existe um container reiniciando no Coolify, a política de reinício geralmente está apenas tentando recuperar um processo que encerra logo após iniciar. Aumentar o número de tentativas ou reiniciar manualmente pode esconder o padrão por alguns minutos, mas não corrige a origem.

Container reiniciando é sintoma; o objetivo é descobrir por que o processo principal está encerrando.

Um healthcheck falho merece uma distinção: ele pode deixar o container marcado como não saudável e impedir o Traefik de enviar tráfego, mesmo que o processo ainda esteja ativo. Em atualizações graduais, também pode impedir que a nova versão assuma o tráfego. O teste deve consultar uma rota que represente a saúde real da aplicação e usar a porta correta.

Erros 502, 503 e 504 no Coolify

Esses códigos normalmente são exibidos por uma camada intermediária, como Traefik ou Cloudflare. Eles indicam em qual trecho da comunicação houve falha, mas não identificam sozinhos a causa final.

Compare o momento do erro com os logs do Traefik e da aplicação. Se houver Cloudflare na frente do servidor, observe também quem gerou a página de erro e os cabeçalhos da resposta; um 502 ou 504 na borda pode ter uma origem diferente de um erro emitido diretamente pelo proxy do Coolify.

Problemas com domínio e SSL no Coolify

Ao cadastrar uma URL com https://, o Coolify configura o proxy e solicita o certificado. Quando existe um problema com SSL no Coolify ou um problema com domínio no Coolify, verifique toda a cadeia:

1. 1.Domínio
2. 2.DNS
3. 3.Cloudflare, quando usada
4. 4.Servidor
5. 5.Traefik
6. 6.Aplicação

Um container ativo não garante que o domínio funcione; DNS correto não garante que a aplicação esteja saudável. O SSL também pode falhar com a aplicação em execução, e a Cloudflare acrescenta outra camada quando utilizada. Veja como avaliar DNS e domínios.

• DNS incorreto: registros A ou AAAA apontam para outro servidor, mantêm IP antigo ou ainda não estão resolvendo de forma consistente.
• Proxy da Cloudflare: o modo com proxy pode interferir na validação HTTP ou TLS. Para diagnosticar, compare com o registro temporariamente em modo somente DNS ou use um desafio DNS corretamente configurado.
• Portas bloqueadas: a validação HTTP padrão exige que a porta 80 esteja publicamente acessível; HTTPS depende da porta 443 para atender os usuários.
• Certificado não emitido: os logs do proxy podem revelar falha de validação, bloqueio por WAF, limite do emissor ou problema no resolvedor configurado.
• Domínio duplicado: o mesmo hostname associado a recursos diferentes pode criar conflito de roteamento e levar o tráfego ao serviço errado.
• Traefik configurado incorretamente: labels personalizadas, porta de destino errada, middleware ou regra de host podem impedir que a rota encontre a aplicação.

Evite apagar arquivos de certificados ou reconfigurar o Traefik como primeira tentativa. Antes, confirme DNS, portas e mensagens do proxy. Alterações diretas no proxy podem afetar todas as aplicações hospedadas no servidor.

Deploy do Coolify falhando: onde procurar

Um erro no deploy Coolify pode ocorrer antes da imagem existir, durante a criação do container ou na validação da nova versão. Identifique em qual fase o processo parou antes de alterar o projeto.

Banco de dados e volumes: onde o risco é maior

Containers são substituíveis; dados de produção não. Arquivos importantes gravados apenas dentro da camada do container podem desaparecer quando uma nova versão o substitui. No Coolify, configure volume Docker ou bind mount com o caminho de destino correto para tudo que precisa sobreviver aos deploys.

Um backup presente no mesmo disco não protege contra perda da VPS. O Coolify oferece recursos de backup programado para cenários compatíveis e integração com armazenamento S3, mas a configuração só é confiável quando o arquivo é verificado e a restauração é testada.

Checklist de diagnóstico rápido do Coolify

Antes de solicitar suporte Coolify, reúna estas informações:

1. 1Defina se a falha afeta o painel, todas as aplicações ou apenas um recurso.
2. 2Confirme no provedor se a VPS está ligada e acessível pela rede e por SSH.
3. 3Registre CPU, memória, swap, espaço em disco e inodes no momento da falha.
4. 4Liste containers parados, reiniciando ou unhealthy e anote a contagem de reinícios.
5. 5Salve os logs do deploy, da aplicação, do banco, do Docker e do proxy no mesmo intervalo de tempo.
6. 6Compare variáveis de ambiente e configurações com a última versão que funcionou, sem expor segredos.
7. 7Confirme a porta em que a aplicação escuta e a porta informada ao Coolify.
8. 8Valide registros A e AAAA, IP de destino, Cloudflare, portas 80 e 443 e domínio cadastrado.
9. 9Verifique o healthcheck: caminho, porta, dependências e tempo necessário para a aplicação iniciar.
10. 10Confirme volume persistente, permissões, estado do banco e existência de backup restaurável.
11. 11Registre a mudança mais recente: deploy, atualização, DNS, certificado, firewall ou aumento de tráfego.
12. 12Evite limpeza do Docker, exclusão de volumes ou recriação do banco até entender o impacto.

Quando faz sentido procurar suporte para Coolify?

Vale buscar suporte quando a indisponibilidade afeta clientes, não existe backup validado, há risco para o banco de dados ou a causa envolve várias camadas ao mesmo tempo.

• O painel não abre ou todas as aplicações caíram.
• Aparece erro 502, 503 ou 504.
• O deploy começou a falhar ou o container entra em loop de reinício.
• SSL deixou de funcionar ou o domínio não abre.
• Traefik não encaminha para a aplicação.
• O servidor está sem espaço ou a aplicação funciona internamente, mas não pelo domínio.
• Uma atualização causou instabilidade ou a causa não fica clara nos logs.

Mudanças incorretas podem aumentar o tempo de parada, trocar uma indisponibilidade parcial por uma falha geral ou causar perda de dados. Um diagnóstico especializado relaciona métricas, estado dos containers, logs, rede, proxy e mudanças recentes antes de propor uma correção.

A Jupiter TI oferece diagnóstico remoto de servidores, suporte ao Coolify, análise de deploys, containers, Docker, Traefik, DNS e SSL, além de backup, monitoramento e otimização de VPS para empresas em todo o Brasil.

Quando a falha envolve o proxy ou a aplicação publicada, veja também os serviços de servidores web.

Fontes técnicas para aprofundar o diagnóstico

A interface e o comportamento podem variar conforme a versão do Coolify, o proxy escolhido e a arquitetura do ambiente. Consulte a documentação oficial correspondente à instalação antes de alterar configurações.

• Coolify: diagnóstico de erro 502
• Coolify: healthchecks e roteamento
• Coolify: domínios e certificados SSL
• Coolify: portas e firewall
• Coolify: armazenamento persistente
• Coolify: backups de bancos de dados