Docs Menu

Docs HomeMongoDB Atlas

Restore from a Locally-Downloaded Snapshot

On this page

  • Restore Considerations
  • Procedure
  • Considerations

Atlas provides a mechanism for downloading dedicated cluster, shared cluster, and legacy backup snapshots as compressed files.

In addition to the prerequisites, consider the following requirements and limitations when restoring from a locally-downloaded snapshot.

  • This feature is unavailable for M0 clusters and for serverless instances.

  • The downloaded files consist of the raw files copied from the data directory. mongorestore is incompatible with these files. To access the data files, use the following procedure to start a mongod instance and point it to the extract directory.

Important

Atlas deletes all existing data on the target database deployment prior to the restore. Depending on the type of restore taking place, the target cluster may be unavailable for the duration of the restore.

When you manually download a cloud backup snapshot, your download might get interrupted for some reason. Atlas keeps the request alive and allows you to restart it as long as the most recent download failure occurred no more than one hour ago.

1
  1. Click Database.

  2. Click the name of your Atlas Cluster.

  3. Click the Backup tab.

  4. Click the Snapshots sub-tab.

  5. In the Actions column, expand the Actions menu, and click Download for the snapshot that you want to download.

    Atlas generates a one-time use download link that expires within 1 hour after its creation.

    The amount of time to create this link increases with the size of the Atlas cluster.

Once the download is ready, Atlas:

  • Emails you an alert that your snapshot download is ready.

  • Displays the download link in the Restores & Downloads tab.

Note

Available via API

As another option, you can request a restore snapshot using the API.

2

If the current project IP access list ranges do not cover the target client IP or CIDR address, click Add or Modify your IP Addresses to make changes to your Atlas project IP access list.

3
  1. Click Database.

  2. Click the name of your Atlas Cluster.

  3. Click the Backup tab.

  4. Click the Restores & Downloads sub-tab.

  5. Navigate to the restore snapshot you created.

  6. Click Download.

4

Atlas compresses the snapshot into a .tar.gz file. This archive includes the snapshot and the mongod logs.

  1. Extract the files in the archive.

    Example

    The following command uses the tar utility to extract a tar``archive with ``gzip compression.

    tar -xvzf ~/Downloads/mongodb-snapshots/my-cluster-snapshot.tar.gz
  2. Access the data files by starting a mongod instance on the host and pointing it at the extract directory using the --dbpath option.

    Example

    The following command starts a mongod instance using the extracted data file directory:

    mongod --dbpath ~/Downloads/mongodb-snapshots/my-cluster-snapshot/
←  Restore from Continuous Cloud BackupRestore from a Snapshot Using Encryption at Rest →
Share Feedback
© 2023 MongoDB, Inc.

About

  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.