Navigation

Archive Snapshots

Note

This feature is not available for M0 (Free Tier) clusters. For more information, see Atlas M0 (Free Tier) Limitations.

Atlas provides a mechanism for downloading cloud provider, continuous backup, and M2/M5 snapshots as compressed files.

Procedure

1

From the Snapshots tab, click Download to retrieve your backup data via HTTPS and restore manually.

Atlas generates a one-time use download link that expires within 4 hours. Once the download is ready, Atlas emails you a link to download the snapshot. Atlas also displays the download link in the Restore History tab.

2

Add the IP or CIDR address of the client to your Atlas project whitelist.

If the current project whitelist 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 whitelist.

3
4

Use your preferred archive utility to extract the archive and access the data files.

Atlas compresses the snapshot into a .tar.gz file.

Once extracted, you can 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 uses the tar utility to extract a tar archive with gzip compression:

tar -xvzf ~/Downloads/mongodb-snapshots/my-cluster-snapshot.tar.gz

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

mongod --dbpath ~/Downloads/mongodb-snapshots/my-cluster-snapshot/
1

Click Continuous Backup in the left navigation.

Continuous Backup button
2

Chose the cluster you want to download a backup snapshot of.

The Overview tab on the Continuous Backup page lists the project’s clusters.

  • If backup is enabled for the cluster, the Status is Active.
  • If backup is disabled for the cluster, the Status is Inactive.

To begin restoring a cluster either:

  • Hover over the Active status of the cluster and click Restore or Download or
  • From the ellipsis h icon menu next to the cluster select Restore.
3

Select the snapshot you want to download, then click Next.

4

Click Download.

5
5

Use your preferred archive utility to extract the archive and access the data files.

Atlas compresses the snapshot into a .tar.gz file.

Once extracted, you can 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 uses the tar utility to extract a tar archive with gzip compression:

tar -xvzf ~/Downloads/mongodb-snapshots/my-cluster-snapshot.tar.gz

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

mongod --dbpath ~/Downloads/mongodb-snapshots/my-cluster-snapshot/
1

In the Snapshots tab, locate the snapshot you wish to download in the All Daily Snapshots table.

2

In the Actions column of the table, click Download.

3
4

Use your preferred archive utility to extract the archive and access the data files.

Atlas compresses the snapshot into a .tar.gz file.

Once extracted, you can 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 uses the tar utility to extract a tar archive with gzip compression:

tar -xvzf ~/Downloads/mongodb-snapshots/my-cluster-snapshot.tar.gz

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

mongod --dbpath ~/Downloads/mongodb-snapshots/my-cluster-snapshot/