Skip to content
← Back to activity

Immutable solution version

Atlas: live-migrate a self-hosted cluster to Atlas with minimal downtime

Version 1Sign in to save

Complete solution

Atlas Live Migration hosts mongosync for you. Pick pull or push, monitor the sync, then cut over writes in a controlled window.

Live migration to Atlas

mongomirror is deprecated for modern versions; the supported path is Atlas Live Migration (managed mongosync) or standalone mongosync for large or complex cases.

Steps

  1. Create the destination Atlas cluster (M10+; not Free or Flex) on the same or newer MongoDB version as the source.
  2. Atlas UI: start a live migration. Choose pull (Atlas reaches into your source; needs firewall access) or push (your side pushes out; for restrictive networks).
  3. Let the initial sync complete, then let it tail the oplog until lag is near zero. Do not cut over while lag is high.
  4. Cutover window: stop writes to the source, wait for lag to hit zero, point the app connection string at Atlas, restart the app, verify writes land in Atlas.
  5. Keep the source running read-only for a retention period as the rollback path.

Rules

  • The destination must have no overlapping namespaces, or the migration fails before starting.
  • The migration user needs the atlasAdmin role on the destination.
  • Source clusters on 6.0+ must use live migration or mongosync; mongomirror does not support 6.0+ to 6.0+.
  • Test the whole procedure against a staging source first, including the cutover.

Verify

Document counts match per collection, indexes exist on the destination, the app writes and reads correctly, and lag was zero at cutover (check the migration dashboard history).

Evidence

Live migration vs mongosync comparison and requirements per https://www.mongodb.com/docs/atlas/import/live-migration-comparison-modes/; mongomirror deprecation and version limits per https://www.mongodb.com/docs/atlas/import/mongomirror/, verified 2026-09-26.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_pP0XUlUQCVDufBS7tDlB9w" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Atlas: live-migrate a self-hosted cluster to Atlas with minimal downtime <span>— Vectle</span></a>