Restore Your Cluster
On this page
Atlas lets you restore data from
To learn more about:
Cloud Backup, see Restore Your Cluster.
Restoring data from a legacy backup snapshot, see Restore a Cluster from a Legacy Backup Snapshot.
Faster cross-project restores, see Enable Faster Cross-Project Restores.
Restoring snapshots using Encryption at Rest using Customer Key Management, see Restore from a Snapshot Using Encryption at Rest.
Required Access
To view cloud backup restore jobs, you must have Project Owner
access or higher to the project.
Limitations
You can't restore a snapshot created from a MongoDB 7.0 sharded cluster with 3 or fewer shards to a MongoDB 8.0 sharded cluster with 3 or fewer shards with the default embedded config server configuration on MongoDB 8.0. You must first disable the Managed Configs to create a sharded cluster with dedicated config server before restoring the snapshot.
Prerequisites
Stop Client Operations during Restoration
You must ensure that the target Atlas cluster doesn't receive client requests during restoration. You can restore to a new cluster and reconfigure your application to use that new cluster once it is running for maximum uptime.
View Status of Snapshot Restorations
View Cluster Restore Jobs
To list all cloud backup restore jobs for your cluster using the Atlas CLI, run the following command:
atlas backups restores describe <restoreJobId> [options]
To return the details for the cloud backup restore job you specify using the Atlas CLI, run the following command:
atlas accessLists create [entry] [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas backups restores describe and atlas accessLists create.
View Serverless Instance Restore Jobs
To return all cloud backup restore jobs for the specified serverless instance in your project using the Atlas CLI, run the following command:
atlas serverless backups restores describe [options]
To describe a cloud backup restore job using the Atlas CLI, run the following command:
atlas accessLists create [entry] [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas serverless backups restores describe and atlas accessLists create.
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:
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.
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.
See also Troubleshoot Encryption at Rest.