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.

backup tab

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.

backup success

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.

online 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.

auto backup

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.