Backups

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

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

Downloading

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

Restoring

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

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

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:

• from the Compose UI on the Backups page, there is a green Back up now button.
• from the Compose API with a POST request to /2016-07/deployments/:deployment_id/backups

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:

• MongoDB
• PostgreSQL
• Redis
• RethinkDB
• RabbitMQ
• etcd
• Compose for MySQL
• MongoDB Classic

Backups Quick View Table

---

Still Need Help?

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