Navigation
  • Restoration >
  • Restore a Cluster from a Cloud Provider Snapshot

Restore a Cluster from a Cloud Provider Snapshot

Note

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

Atlas lets you restore data from a scheduled cloud provider snapshot. For information on cloud provider snapshot backups, see Cloud Provider Snapshots.

For instructions on restoring data from a continuous backup snapshot, see Restore a Cluster from a Continuous Backup Snapshot.

Restore a Cluster

Restoring Snapshots for Clusters using Encryption at Rest

Atlas automatically encrypts Cloud Provider Snapshots for clusters using Encryption at Rest, in addition to the existing encryption applied to all Atlas storage and snapshot volumes. For documentation on restoring an encrypted snapshot, see Restore a Snapshot of a Cluster with Encryption at Rest

The following instructions only apply to snapshots for clusters not using Encryption at Rest.

  1. From the Clusters view, click on the cluster name.

  2. Click Backup in the left-hand navigation.

    If the cluster has no Backup tab, then Atlas backups are disabled for that cluster and no snapshots are available. You can enable backups when scaling the cluster.

  3. Select a cluster’s snapshot to restore.

    Hover over the Active status of the cluster and click Restore or Download.

    Alternatively, you can click the ... button for the cluster and select the Restore.

  4. Follow the prompts to restore your cluster. You may choose to:

Download your Snapshot via HTTPS

From the Restore dialog, 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.

You must add the IP or CIDR address of the client to your Atlas project whitelist. The Restore prompt displays your Existing IP 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

Restore your Snapshot to an Atlas Project

Important

The restore process requires downtime for the target cluster.

From the Restore dialog, click Restore to have Atlas restore to a selected cluster. Atlas can only restore to a replica set cluster that does not use Encryption at Rest. The target cluster must run the same or newer version of MongoDB as the snapshot MongoDB version.

You can restore to any Atlas project for which the authenticated Atlas user has the Project Owner role.

Restore your Snapshot to a Cloud Manager Project

Important

The restore process requires downtime for the target cluster.

From the Restore dialog, click Restore to have Atlas restore to a selected Cloud Manager project. Atlas can only restore to a replica set cluster. The target cluster must run the same or newer version of MongoDB as the snapshot MongoDB version.

You can restore to any Cloud Manager project for which the authenticated Atlas user has any of the following roles:

You must add the IP or CIDR addresses of the target Cloud Manager project to your Atlas project whitelist. The Restore prompt displays your Existing IP Whitelist.

If the current project whitelist ranges do not cover the target Cloud Manager project IP or CIDR addresses, click Add or Modify your IP Addresses to make changes to your Atlas project whitelist.

Restore a Snapshot of a Cluster with Encryption at Rest

Important

Snapshots of clusters using Encryption at Rest can only restore to other clusters that use Encryption at Rest. You cannot restore a snapshot with Encryption at Rest to a Cloud Manager project, nor can you download the snapshot.

  1. From the Clusters view, click on the cluster name.

  2. Click Backup in the left-hand navigation.

    If the cluster has no Backup tab, then Atlas backups are disabled for that cluster and no snapshots are available. You can enable backups when scaling the cluster.

  3. Click Restore in the Actions column for the snapshot you want to restore.

  4. From the Restore dialog, select the Atlas Project to restore to. You can restore to any Atlas project for which the authenticated Atlas user has the Project Owner role.

  5. Select the Cluster to restore to. You can only restore to a Atlas replica set running Encryption at Rest. The target cluster must run the same or greater version of MongoDB as the MongoDB Version of the snapshot.

    If the target project does not have a cluster with Encryption at Rest enabled, you can either deploy a cluster with Encryption at Rest, or enable Encryption at Rest in an existing cluster.

After the restoration procedure, Atlas triggers a key rotation for MongoDB encryption key. Atlas then encrypts the new MongoDB encryption keys using the target project CMK.

If Atlas cannot access the snapshot CMK, Atlas cannot restore the snapshot. CMK access validation may fail for any of the following reasons:

  • The AWS IAM credentials for the snapshot, source project, or destination project do not provide access to the enabled CMK.

    Configure the IAM user which the source or target project uses to have access to the CMK identified by the snapshot CMK ID. For complete documentation on configuring the IAM user for Atlas Encryption at Rest, see Encryption at Rest.

  • The CMK is accessible, but not enabled.

    You must enable the CMK from the AWS IAM interface for Atlas to restore the snapshot.

  • The CMK is deleted. Atlas cannot restore a snapshot whose CMK was deleted.

For complete documentation on configuring Encryption at Rest, see Encryption at Rest. You can either deploy a cluster with Encryption at Rest, or enable Encryption at Rest in an existing cluster.