Navigation

Manual Restore One Snapshot

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, legacy backup, and M2/M5 snapshots as compressed files.

Procedure

To learn more about this backup type, see Cloud Backups.

1

Request your snapshot.

  1. Click Clusters.

  2. Click the name of your Atlas Cluster.

  3. Click the Backup tab.

  4. Click the Snapshots sub-tab.

  5. Click Download.

    Atlas generates a one-time use download link that expires within 4 hours 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 Restore History tab.

Available via API

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

2

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

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

Retrieve your snapshot.

  1. Click Clusters.
  2. Click the name of your Atlas Cluster.
  3. Click the Backup tab.
  4. Click the Restore History sub-tab.
  5. Navigate to the restore snapshot you created.
  6. Click Download.

You can’t download your snapshot if a prior snapshot download link hasn’t been clicked.

4

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

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

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/

To learn more about this backup type, see Legacy Backups.

1

Click Legacy Backup in the left navigation.

Legacy Backup button
2

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

The Overview tab on the Legacy 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/

You can download a snapshot for any M2/M5 cluster in a project for which you have the Project Owner role.

To learn more about this backup type, see Shared Tier Backups.

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/