Backup your Service
Zeabur provides off-site backup functionality for Dev Plan and above. Your backups will be securely and temporarily stored in our Amazon S3 storage space, which will not occupy space on your existing host and will not be subject to additional charges.
For database services, Zeabur supports online and automatic backups, allowing your database to be backed up without downtime. For other stateful services, we also provide offline off-site backup functionality after pausing.
Offline Offsite Backup
If you have not mounted volumes, the backup feature will not be displayed. “Backup” will only back up the data within the volumes; other files in the service (such as source code) will not be backed up.
First, you need to suspend the service. Click on “Settings” → “Suspend Service” for the service to suspend it. Note that suspension will not cause data loss.
Next, click on the “Backup” tab of your service, and you will see the “Backup” button.
After clicking it, Zeabur will automatically back up your service in the background, and you can wait a few minutes. Once the backup is complete, you will see a download button, which you can click to download the backup file. The content of the backup file is the complete content of the folder where your service’s volumes are mounted.
After the backup is complete, you can go to “Overview” and click “Restart Service” to resume your service.
Online Offsite Backup
Zeabur supports online offsite backup for databases such as PostgreSQL, MySQL, MariaDB, MongoDB, etc., allowing secure backups without pausing your service. Additionally, the “Online Offsite Backup” service also supports automatic backup.
Similar to “Offline Offsite Backup,” after clicking the “Backup” button, Zeabur will automatically back up in the background, and you can wait a few minutes. Once the backup is complete, you will also see a download button, which you can click to download the backup file.
The content of the backup file will be a standard dump file of the database (for PostgreSQL, MySQL, it is a .sql
file; for MongoDB, it is various .bson
files). These backup files can be restored later using built-in database restoration tools (such as psql
and mongoimport
).
Automatic Backup
Zeabur also supports automatic backups, currently offering daily backups at a set time.
After enabling “Automatic Backup,” you can set the backup time in UTC. It’s best to choose a time when your service experiences the least traffic. You can refer to the “At your local time” hint next to it to see what this UTC period corresponds to in your local time.
Backup Retention Period and API Retrieval Method
Zeabur only retains your backups for 7 days. Backups exceeding this period will be automatically deleted. If you need to store backups for a longer period, please download the backup files yourself and store them elsewhere.
Currently, Zeabur does not yet support backing up to your own Amazon S3 storage space, but you can write a program to retrieve backups by calling the Zeabur Public API and store them in your own storage space of your choice:
query Backups($environmentId: ObjectID!, $serviceId: ObjectID!) {
backups(environmentID: $environmentId, serviceID: $serviceId) {
createdAt
downloadURL
status
}
}
Example response:
{
"data": {
"backups": [
{
"createdAt": "2025-06-23T16:00:10.864Z",
"downloadURL": "https://backup.zeabur.com/XXXXXX",
"status": "SUCCESS"
}
]
}
}
You can use the backup file download link (downloadURL
) along with the backup time (createdAt
) to store the backup files.