Browse articles

Database backup

# My backup failed. Where can I see why?

Open History, filter by Failed, then read the Run failed message and the Agent log. Here are the most common causes and how to run the backup again.

2 min readUpdated: October 22, 2026[Baca dalam Bahasa Indonesia](/help/backup-gagal)

Every run records the complete log from the agent. From it you can see at which step the backup stopped.

## Viewing the log

1.  Open **History** and choose the **Failed** filter.
2.  Click the failed run.
3.  Read the **Run failed** box for the short message, then the **Agent log** for the agent's full output.

Failed runs are also recorded as alerts under **Settings → Alerts**, and the **Last run failed** card on the **Backup jobs** page counts the jobs that need attention. If notification channels are set up, you receive a `backup_failed` email or webhook.

## Common causes

-   **Database credentials or user privileges changed**: test the connection again on the server page. See [Connection test failed](/help/uji-koneksi-gagal).
-   **Dump tool version mismatch**: for example a `pg_dump` older than the PostgreSQL server. Update the database client package.
-   **Incremental prerequisites not met**: MySQL needs `log_bin` enabled and replication privileges, PostgreSQL needs one specific database, MongoDB must be a replica set with `mongosh` installed.
-   **The destination is unreachable**: an external bucket key was revoked, the bucket is full, or the Google Drive connection expired. Check **Settings → Storage destinations**.
-   **No passphrase set** for an encrypted job.
-   **The agent restarted or the server went down** while the backup was running.

## Running it again

Once the cause is fixed, open the job page and click **Run now**. For incremental jobs, click **Full now** if the incremental chain needs to start again from a new full.

If the cause is still unclear, open a support ticket and include the run ID and an excerpt of the agent log. Do not include passwords or secrets.

## See also

-   [Scheduling backups](/docs/jadwal-backup)
-   [Backup destinations](/docs/tujuan-backup)

Still need help?

Open a support ticket from the dashboard and our team will reply as soon as possible.

[Browse the docs](/en/docs)[Open a ticket](/app/support/new)