Restore from a Scheduled or On-Demand Snapshot
On this page
Atlas lets you restore data from a scheduled or on-demand Cloud Backup, including snapshots from different projects or organizations. The following sections describe restoring from a snapshot without Encryption at Rest using Customer Key Management. To restore from a snapshot using Encryption at Rest using Customer Key Management, see Restore from a Snapshot Using Encryption at Rest.
Note
You can only perform cross-organization restores through the Atlas UI.
Restore Considerations
In addition to the prerequisites, consider the following requirements and limitations when restoring from a scheduled or on-demand Cloud Backup.
If the
DefaultRWConcern
value on the source snapshot differs from theDefaultRWConcern
value on the target cluster, Atlas overrides the value on the source snapshot with the value on the target cluster. If there is no value configured for theDefaultRWConcern
on the target cluster, Atlas keeps the value ofDefaultRWConcern
from the snapshot without explicit configuration. This may differ from the default value for that MongoDB version.
This feature is not available for
M0
clusters.For
M10+
dedicated clusters running MongoDB 4.2 or higher, Atlas will restore Atlas Search index definitions from a Cloud Backup snapshot. Atlas doesn't restore the index data, so themongot
processes perform initial syncs for all restored index definitions. If you've defined large search indexes on your cluster, you might experience delays during snapshot restorations.Note
When you restore the data from the snapshot, the Atlas Search index definitions from the snapshot replace any existing Atlas Search index definitions.
Sharded Clusters
If you are restoring from a sharded cluster, the source and target clusters must have the same number of shards.
Atlas can't restore a sharded cluster snapshot to a replica set.
Flex Clusters
If your cluster has been migrated from an M2
or M5
cluster to a
Flex cluster, you have access to the last 8 backup snapshots since the date
of the migration.
M2/M5 Clusters
Starting with MongoDB 5.0, you can restore snapshots of clusters that run only the two most recent major versions of MongoDB to
M2
andM5
clusters.Example
You can restore snapshots taken from clusters that run MongoDB 4.2 to an
M2
orM5
cluster that runs MongoDB 5.0.You can't restore snapshots taken from clusters that run MongoDB 4.0 to an
M2
orM5
cluster that runs MongoDB 5.0.
Serverless Instances
Atlas can't restore snapshots from shared clusters, dedicated clusters, or Cloud Manager to a Serverless instance.
If you are restoring from a Serverless instance, you can only restore the two most recent snapshots.
Recommendations to Optimize Restore Times
To optimize performance and reduce the amount of time it takes to restore, follow these principles where applicable:
Select a target cluster that isn't global or multi-cloud.
Select a multi-region cluster only if copies of the snapshot you plan to restore exist in every region of that cluster.
Select a target cluster that belongs to the same Atlas project and the same cloud provider region as the snapshot.
Select a cluster tier with the same storage capacity as the capacity of the original volume used by the source cluster.
If the target cluster runs on AWS with configured IOPS, select the configured IOPS to fall within the configured range.
Select a cluster that is not configured to use NVMe storage. NVMe storage degrades restore performance.
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.
Required Access
To start a restore job, you must have Project Owner
access or higher to the project.
To watch a backup restore job until it completes, you must have
Project Read Only
access or higher to the project.
Procedure
Atlas deletes all existing data on the target cluster prior to the restore. The target cluster is unavailable for the duration of the restore.
Restore a Cluster
To start a restore job for your project and cluster using the Atlas CLI, run the following command:
atlas backups restores start <automated|download|pointInTime> [options]
To watch for a specific restore job to complete using the Atlas CLI, run the following command:
atlas backups restores watch <restoreJobId> [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas backups restores start and atlas backups restores watch.
Restore a Serverless Instance
To start a restore job for your serverless instance using the Atlas CLI, run the following command:
atlas serverless backups restores create [options]
To watch the specified backup restore job until it completes using the Atlas CLI, run the following command:
atlas serverless backups restores watch [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas serverless backups restores create and atlas serverless backups restores watch.
The Atlas Administration API provides different endpoints for restoring
M10+
clusters, M2/M5
clusters and
Serverless instances.
Restore One Snapshot of One Cluster Create One Restore Job from One M2 or M5 Cluster Restore One Snapshot of One Serverless Instance
Restore a Cluster
In Atlas, go to the Clusters page for your project.
If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it's not already displayed, select your desired project from the Projects menu in the navigation bar.
If it's not already displayed, click Clusters in the sidebar.
The Clusters page displays.
Go to the Backup page for your cluster.
Click your cluster's name.
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 you scale the cluster.
The Backup page displays.
Select the snapshot to restore and click Restore.
In the Actions column, expand the Actions menu, and click Restore for the snapshot that you want to restore.
In the modal window, select the target project and the target cluster from the dropdown menu. If the target cluster is part of a different project or organization than your source cluster, you can enter the name of and select the target project from the dropdown menu.
Follow the prompt and click Restore.
Restart your application and ensure it uses the new target cluster.