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 see | Page |
|---|---|
| No email with your Deplo login, Deplo missing on a server you bought, a payment or refund question | Buying from hosting providers |
| A build fails, a deploy is queued, the app does not answer, a push does not deploy | Deploys and builds |
| A container keeps restarting or is unhealthy, a rollback fails, the server is full | Deploys and builds |
| DNS, HTTPS, a 404, a redirect loop, or the panel is unreachable | Domains and TLS |
| A server is provisioning, offline or unusable, every deploy fails on one server, metrics are empty | Servers and agents |
| A database will not start or connect, a backup or restore fails | Databases and backups |
| You cannot sign in, a passkey is unusable, a token returns 401 or 403, a button is missing | Sign-in and access |
Check these first
- Open the log: the deployment's build log, the app's Logs tab, or a destination's Connection log.
- Check the server: Check readiness on its Overview tab in Settings -> Servers.
- 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 see | What it means |
|---|---|
| A deploy failed, the site still works | A 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 Skipped | It never started: the container was not running, the previous run was still going, or Deplo stopped first |
| Cron run Unknown | Deplo lost track of it when the server agent restarted. The command may have completed |
| Server Unknown | The health reading is stale. Press Refresh |
| Readiness skipped | Deplo 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.
- Bugs: the issue tracker.
- Security issues: never in a public issue. Open a
private security advisory, or
email
[email protected].
Did this page help you?