Navigation

Restore a Cluster from a Cloud Backup

Feature unavailable in Free and Shared-Tier Clusters

This feature is not available for M0 (Free Tier), M2, and M5 clusters. To learn more about which features are unavailable, see Atlas M0 (Free Tier), M2, and M5 Limitations.

Atlas lets you restore data from a scheduled Cloud Backup. For information on Cloud Backup backups, see Cloud Backups.

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

Restore Restrictions

  • Atlas can only restore to a replica set or sharded cluster that uses the same encryption provider as the source snapshot cluster.
  • The target cluster must run the same or newer release version of MongoDB as the snapshot MongoDB version.

Fallback Snapshots

If a scheduled snapshot fails for any reason, Atlas attempts to repeat the snapshot process. If necessary, you may use the resulting fallback snapshot to restore the cluster. This isn’t recommended: fallback snapshots use a different process from regular snapshots. They may contain inconsistent data.

Fallback snapshots are marked in the UI with a warning icon, and a warning message appears in the restore modal window if the restore uses a fallback snapshot.

Warning

Restoring your cluster from a fallback snapshot may result in inconsistent data across your cluster, and should be considered an option of last resort.

Prerequisites

Stop Client Operations during Restoration

You must ensure that the target Atlas cluster does not receive client requests during restoration. You must either:

  • Restore to a new Atlas cluster and reconfigure your application to use that new cluster once the new deployment is running, or
  • Ensure that the target Atlas cluster cannot receive client requests while you restore data.

Procedure

Restoring Snapshots for Clusters using Encryption at Rest

Atlas automatically encrypts Cloud Backups for clusters using Encryption at Rest using Customer Key Management, 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 the Backup tab.

    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.

    Click Restore or Download.

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

You can enable Continuous Cloud Backups when you create or scale a cluster.

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

  2. Click the Backup tab.

    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 the Point in Time Restore button on the far right side of the screen.

  4. Select either the Date & Time or Oplog Timestamp tab.

    Note

    If you select the Date & Time option, you can specify the time of restore with one minute of granularity. If you select the Oplog Timestamp option, you can specify the time of restore with one second of granularity.

  5. Enter the desired point in time to restore from.

  6. Click the Next: Select Cluster button.

  7. Choose a project and cluster to restore to from the dropdown menus.

  8. Click the Restore button.

Restore your Snapshot to an Atlas Cluster

Important

Atlas deletes all existing data on the target cluster prior to the restore. The cluster will be unavailable for the duration of the restore.

You can restore to any Atlas cluster in a project for which you have the Project Owner role.

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

  2. From the Restore dialog, select the target cluster to which you want to restore.

    Note

    Restores improve their performance if the target cluster:

    • Exists in the same project as the snapshot.
    • Exists in the same cloud provider region as the snapshot.
    • Doesn’t use NVMe storage.
    • Equals or exceeds the disk size of the snapshot’s original total, not used, disk size.

    For the fastest possible restore, select a target cluster that:

    • Exists in the same Atlas project as the snapshot.
    • Exists in the same cloud provider region as the snapshot.
    • Has the same storage size as the original cluster that the snapshot was taken from.
  3. Click Restore.

  4. Restart your application and ensure it uses the new target cluster.

Restore a Snapshot of a Cluster with Encryption at Rest

Important

Snapshots of clusters using Encryption at Rest using your Key Management 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.

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.

Clusters which use AWS KMS encrypt their PIT restore oplog data with the customer’s CMK. The current CMK must be valid for the encrypted oplog data to perform a restore from a snapshot.

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

  2. Click the Backup tab.

    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 modifying the cluster.

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

  4. From the Restore dialog, select the target Atlas Project to which you want to restore. 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 an 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.

    After the restoration procedure, Atlas triggers a key rotation for MongoDB encryption key. Atlas then encrypts the new MongoDB encryption keys based on the configured Encryption at Rest provider for the target cluster.

  6. Restart your application and ensure it uses the new target cluster.

Troubleshooting Encryption at Rest

If Atlas has an issue with the encryption of either the snapshot or the target cluster, it displays one of the following errors:

Error Result
Cannot restore a non-encrypted snapshot to a cluster with Encryption at Rest enabled. The snapshot cannot be restored to Atlas.
Target cluster does not have encryption enabled. You can either deploy a new target cluster with Encryption at Rest, or enable Encryption at Rest on your desired target cluster.
Encryption provider of target cluster does not match selected snapshot’s encryption provider.

The encryption provider for the snapshot and target cluster do not match. You can either:

  1. Create a new snapshot with the same encryption provider.
  2. Change the encryption provider for the target cluster.
Encryption credentials on snapshot are not present. Atlas cannot restore a snapshot whose encryption key was deleted.

View Status of Snapshot Restorations

Atlas provides a detailed list of completed and in-progress snapshot restorations, including when Atlas took the snapshot and the snapshot’s delivery type. To view this list, from a cluster’s Backup tab, click the Restore History tab.

The Status column of the table displays the results of completed snapshots, and the progress of snapshots currently being restored.

  • For manually downloaded snapshots, the Status column displays progress while Atlas prepares the download link. Once the download is ready, the column displays the link to download the snapshot.
  • For automated restores and Continuous Cloud Backup restores, the Status column updates as the restoration progresses on each node in the cluster. When the restoration completes, the column displays the time of completion and the cluster to which Atlas restored the snapshot.