Migrate or Import Data
You can bring data from existing MongoDB deployments, JSON, or CSV
files into deployments in Atlas using either:
live migration where Atlas assists you, or
tools for a self-guided migration of data from your existing deployments into Atlas.
Live Migrate to Atlas
Migrate your data from a source cluster into an Atlas MongoDB cluster using one of the following types of guided live migration in the Atlas UI:
Live migration (pull). For instructions, see Live Migrate (Pull) a Cluster into Atlas.
Live migration (push). For instructions, see Live Migrate (Push) a Cluster Monitored by Cloud Manager into Atlas.
This procedure works for most source cluster versions except source replica sets running MongoDB 4.4. and 5.0. To migrate replica sets 4.4 and 5.0 to Atlas, see Legacy Live Migration: Pull Your Data into Atlas.
Legacy Live Migration
If you are migrating a source replica set running MongoDB versions 4.4 or 5.0 to a destination replica set running MongoDB version 6.0, migrate your replica sets with one of the following legacy live migration methods, depending on your deployment's requirements and configuration.
Source Cluster Configuration | Import Strategy |
|---|---|
A source replica set running MongoDB 4.4 or 5.0 that isn't monitored by Cloud Manager or Ops Manager. | Use live migration (pull) where Atlas pulls data from the source deployment and requires access to the source deployment through the deployment's firewall. |
A sharded cluster that isn't monitored by Cloud Manager or Ops Manager. | To live migrate a source sharded cluster, live migrate it to Atlas using this live migration procedure. |
A replica set running MongoDB 4.4 or 5.0 that is monitored by Cloud Manager or Ops Manager. | Use live migration (push) where Cloud Manager or Ops Manager pushes data to Atlas using a secure link-token without requiring access to the source cluster through the cluster's firewall. |
A sharded cluster that is monitored by Cloud Manager or Ops Manager. | To live migrate a source sharded cluster to Atlas, use this live migration procedure. |
A shared multi-tenant cluster, or a cluster where you have no access to the oplog, or a cluster that runs a MongoDB version that is no longer supported. | Use mongorestore. |
A replica set in AWS. |
Additional Reference
To move data to a Serverless instance, use Compass to export and import data, or migrate data with self-managed tools. To learn more, see Serverless Instance Limitations.
To load data into a new cluster in Atlas, see Load Sample Data.
To make a copy of your cluster for testing purposes, see MongoDB Backup Methods.
If the application that you want to migrate requires a near-continuous uptime, contact MongoDB Support and share your uptime requirements and cluster configuration.