Migrate or Import Data
On this page
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.
MongoDB 6.0.8 and Later: Live Migrate to Atlas
If both the source and destination clusters are running MongoDB 6.0.8 or later, you can 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 MongoDB 6.0.8 or Later Cluster into Atlas.
Live migration (push). For instructions, see Live Migrate (Push) a MongoDB 6.0.8 or Later Cluster Monitored by Cloud Manager into Atlas.
Earlier MongoDB Versions: Live Migrate to Atlas
If you are migrating MongoDB versions earlier than 6.0.8, use one of the following migration methods, depending on your deployment's requirements and configuration.
Source Cluster Configuration | Import Strategy |
|---|---|
A MongoDB deployment running MongoDB earlier than 6.0.8 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 MongoDB deployment running MongoDB earlier than 6.0.8 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. For source and destination clusters running MongoDB 6.0.8, push live migration is currently disabled. See MongoDB 6.0.8 and Later: Live Migrate to Atlas. If your source and destination clusters are running MongoDB 6.0.8 or later, you can live migrate to Atlas using this 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 standard "single shard" sharded cluster MongoDB
deployment in Compose. | |
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.