Compose plans include daily, weekly, monthly, and on-demand backups. These backups are included at no additional cost and happen automatically with no configuration required.

Backup Implementation and Schedules

There's a number of ways that Compose backups are taken. They are all designed to minimize, or eliminate, any interruption to your database's availability. A summary of implementation details and backup/restore options can be found in the Quick View Table for the curious.

Whatever the strategy employed to take the backups, they are then maintained based on the following retention schedule:

  • Daily backups for 7 days
  • Weekly backups for 4 weeks
  • Monthly backups for 3 months
  • One on-demand backup, only the most recent on-demand backup is retained

Backup schedule and retention policies are fixed and cannot be altered. If your needs require a different backup scheme, our backups are available for download. From there, you can retain archives in a way that best satisfies your business requirements.

If you have CLI tools or a local installation available, you may also perform automated backups as necessary.

Downloading and/or Restoring Backups

There are different techniques for downloading and restoring backups depending on the database type. Some databases support only downloading your backups, so restoring a database has to be done locally or through command-line tools. Others offer backups that are restorable to a new Compose deployment. Some offer both. The Quick View Table lists the options by deployment type.

You have two options for accessing your backups:

  1. In the Compose UI, on the Backups panel

List of backups in the Backups panel.

  1. Through the Compose API, at the /2016-07/deployments/:deployment_id/backups endpoint. More information about using the API for backups is on the Managing Backups via the Compose API page.


To download a backup file, click on the download icon on the right. (It's the one with the arrow pointing into the box.


Location of the Download link.


To restore a backup to a new Compose deployment, click on the restore icon. (It's the one with the arrow in a circle.)


Location of the Restore link.

You should then see a page where you can name the new deployment, and choose its region.


Restore to a new deployment dialogue and options panel.

Clicking on the Create Deployment button starts the provisioning and the restoration of your data.

On-demand backups

On-demand backups are useful if you plan to make major changes to your deployment like scaling or removing databases, tables, collections, etc.

On-demand backups can be triggered in two ways:

Each deployment only has the most recent on-demand backup available. Taking a new on-demand backup will overwrite the previous on-demand backup of that deployment.

Restoring Backups Locally

Only deployment types that support downloading their backups can be locally restored. The procedure varies by deployment type, so instructions can be found on deployment-specific pages:

Backups Quick View Table

DatabaseBackup StratRestoration Options
MongoDBfile-system snapshot of backup data nodeDownload, Restore
PostgreSQLfile-system backup with WAL logDownload, Restore
Elasticsearchcluster-level snapshots using Elasticsearch Snapshot APIRestore Only
Redisbinary snapshotDownload, Restore
RethinkDB"hot backups on a live cluster" using the RethinkDB command-line utility dumpDownload Only
RabbitMQexport of broker metadata in JSON formatDownload, Restore
etcd3snapshot of keyspaceDownload, Restore
ScyllaScylla - nodetool snapshot on the full-clusterRestore Only
Compose for MySQLDownload, Restore
MongoDB ClassicDownload, Restore

Still Need Help?

If this article didn't solve things, summon a human and get some help!