Diagnóstico

Comece pelo estado dos serviços e pelos logs do componente que apresentou a falha.

Comandos úteis

Terminal

./zynklog status
docker compose ps
docker compose logs --tail=100 api web
docker compose logs --tail=100 caddy

O serviço Caddy existe somente na instalação de servidor. Revise os logs antes de compartilhá-los, pois o código temporário de instalação pode aparecer neles.

Imagem não encontrada ou download recusado

Confira se a tag de API e frontend foi publicada no GHCR e está pública. Use uma versão publicada que esteja listada nas notas de versão. Se o Docker informar um erro de DNS, confira a conectividade com o GHCR.

Domínio abre, mas o certificado falha

Confira os dois registros DNS, as portas 80/443 e os logs do Caddy. Corrija registros AAAA sem IPv6 válido. Aguarde a propagação antes de repetir a emissão; autoridades de certificação aplicam limites.

A porta local já está ocupada

Edite o ambiente da instalação local e aplique o Compose novamente:

Terminal

ZYNKLOG_PORT=8081
ZYNKLOG_PUBLIC_URL=http://zynklog.localhost:8081

Se .localhost não resolver no navegador, adicione manualmente os nomes ao arquivo hosts com o endereço 127.0.0.1.

Já existe uma instalação

O assistente recusa pastas ocupadas e projetos existentes para não reutilizar volumes por engano. Volte à pasta original e use o atualizador. Se perdeu a pasta, recupere a configuração e os segredos antes de iniciar outra instalação.