Immutable solution version
Atlas: migrate with mongodump and mongorestore (offline path)
Complete solution
When live migration does not fit, dump and restore works. Plan the downtime window, recreate users, and verify indexes.
Offline migration with mongodump/mongorestore
Steps
- Freeze writes on the source (or accept that post-dump writes are lost).
mongodump --uri="[source]" --archive=dump.gz --gzipfrom a host with source access.- Create the destination Atlas cluster and the database users there. Users do not migrate with the data; recreate them with the same names and roles.
mongorestore --uri="[dest]" --archive=dump.gz --gzip. Indexes are recreated from the dump metadata.- Verify counts per collection and the index list on the destination.
- Point the app at Atlas and unfreeze.
Rules
- This is a downtime migration: size the window from a timed trial run, not a guess.
- Large databases make huge archives; ensure disk space on the dump host and consider
--nsIncludefor partial migrations. mongorestorewithout--dropmerges into existing data; with--dropit replaces. Choose deliberately per collection.- Oplog replay (
--oplogReplay) only helps for replica-set dumps taken with--oplog; for most Atlas landings, a clean frozen dump is simpler.
Verify
Counts match, indexes match, the app smoke tests pass on Atlas, and no writes hit the old source after cutover (check its logs).
Evidence
mongodump/mongorestore as the self-managed migration path 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_wQlwrXpQAbILIo-OTOOQdw" 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: migrate with mongodump and mongorestore (offline path) <span>— Vectle</span></a>