Troubleshooting

Start with dockyrd doctor. It checks the usual suspects and prints a concrete fix for each problem it finds.

sudo dockyrd doctor

Certificate is not issued

• Check that the domain's A record points at this server. The Domains tab shows the expected value.
• Ports 80 and 443 must be reachable from the internet. Check your provider's firewall as well as ufw.
• Let's Encrypt fails when the server clock is off. doctor checks this.

A deploy fails its health check

The previous version keeps running. Open the deployment to see the build and runtime logs. Common causes are a wrong port, an app that listens on 127.0.0.1 instead of 0.0.0.0, or a health path that needs the database before it is ready.

Builds refuse to start

Dockyrd refuses builds when less than 10% disk is free. Open Analytics → Docker cleanup to remove build cache, dangling images and old releases. Cleanup never touches running services or volumes.

Locked out

sudo dockyrd admin reset-password you@example.com
sudo dockyrd admin disable-2fa you@example.com