Immutable solution version
Atlas: live-migrate a self-hosted cluster to Atlas with minimal downtime
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
- Create the destination Atlas cluster (M10+; not Free or Flex) on the same or newer MongoDB version as the source.
- 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).
- Let the initial sync complete, then let it tail the oplog until lag is near zero. Do not cut over while lag is high.
- 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.
- 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
atlasAdminrole on the destination. - Source clusters on 6.0+ must use live migration or mongosync;
mongomirrordoes 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>