MongoDB - Backups and Restores with the CLI

Find out how to back up and restore your Public Cloud Databases for MongoDB database using the CLI

Last updated 27th July 2022


Public Cloud Databases allow you to focus on building and deploying cloud applications while OVHcloud takes care of the database infrastructure and maintenance in operational conditions.

This guide explains how to manually back up and restore your Public Cloud Database for MongoDB.



Public Cloud Databases perform automatic daily backups of your databases. However, you might need to perform manual backup and restore operations to double-ensure data safety on your end, or for example in order to export and import data across database instances.


Ensure you can connect to your database

Follow the guide MongoDB - Connect with CLI in order to ensure you can connect to your database. That step ensures IP filtering is set up properly and that you have a suitable service URI available.

Install the MongoDB Database Tools

Follow the MongoDB documentation to install the MongoDB Database Tools for your platform. You'll need the mongodump and mongorestore binaries in order to enact the rest of this procedure.

Perform a backup of your data

Back up your database to a file using:

$ mongodump --gzip --archive=path/to/backup.gz --readPreference=secondaryPreferred \

The MongoDB user needs to have sufficient privileges to perform the backup operation. This can be ensured by giving this user the backup role.

This operation might take some time - from a few seconds to a few hours, depending on the amount of data your database holds and your network connection. Once it completes, the file path/to/backup.gz will hold a backup of your data.

Restore your data from a previous backup

This operation might clobber existing data in your database with the data from the backup you restore. Make sure this is what you actually want!

mongorestore merges data

After the restore operation, any data that was stored in your database which isn't also part of the backup file (e.g. other collections or other keys) will be left untouched: That is to say, mongorestore merges data from your backup file with preexisting data in the database.

Restore your database from a backup using:

$ mongorestore --gzip --archive=path/to/backup.gz \

The MongoDB user needs to have sufficient privileges to perform the restore operation. This can be ensured by giving this user the restore role.

Again, depending on the volume of data and your network connection, this operation might take some time. Once it completes, any data contained in your backup file is present in your database.

We want your feedback!

We would love to help answer questions and appreciate any feedback you may have. Join our community of users on

Are you on Discord? Connect to our channel at and interact directly with the team that builds our databases service!

Did you find this guide useful?

Please feel free to give any suggestions in order to improve this documentation.

Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.

Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.

Thank you. Your feedback has been received.

These guides might also interest you...

OVHcloud Community

Access your community space. Ask questions, search for information, post content, and interact with other OVHcloud Community members.

Discuss with the OVHcloud community