Troubleshooting

Find the symptom, check the right log, and fix the common causes.

Start from the symptom, and keep the exact error text and the time it happened.

Find your symptom

What you seePage
No email with your Deplo login, Deplo missing on a server you bought, a payment or refund questionBuying from hosting providers
A build fails, a deploy is queued, the app does not answer, a push does not deployDeploys and builds
A container keeps restarting or is unhealthy, a rollback fails, the server is fullDeploys and builds
DNS, HTTPS, a 404, a redirect loop, or the panel is unreachableDomains and TLS
A server is provisioning, offline or unusable, every deploy fails on one server, metrics are emptyServers and agents
A database will not start or connect, a backup or restore failsDatabases and backups
You cannot sign in, a passkey is unusable, a token returns 401 or 403, a button is missingSign-in and access

Check these first

  1. Open the log: the deployment's build log, the app's Logs tab, or a destination's Connection log.
  2. Check the server: Check readiness on its Overview tab in Settings -> Servers.
  3. Separate the app from its domain: try its generated address, like https://blog-otter-cb00710a.deplo.site. It works: look at DNS or the certificate. It fails: look at the app or the server.

If it worked before, compare with the last good deploy. The change is usually a variable, a dependency, a Git credential, a certificate or a full disk.

Statuses people often misread

What you seeWhat it means
A deploy failed, the site still worksA failed deploy changes nothing: the previous version keeps serving
Preview Over the limit (grey)Stopped at the app's Live previews limit. Redeploy brings back the same URL
Cron run SkippedIt never started: the container was not running, the previous run was still going, or Deplo stopped first
Cron run UnknownDeplo lost track of it when the server agent restarted. The command may have completed
Server UnknownThe health reading is stale. Press Refresh
Readiness skippedDeplo could not evaluate that check. It is not a pass

If you still need help

Note the app, the server, the deploy time, the exact error and the last good deploy.

Did this page help you?

On this page