This page describes changes and new features introduced in MongoDB Mongosync 1.20.
1.20.0 Release
April 21, 2026
New Features
Adds the
INITIALIZINGstate to the/progressAPI response. Seeprogressfor more details.mongosyncnow requires users to pass the new--enableCappedCollectionHandlingflag during start if new capped collections will be created while the migration is ongoing.
Fixed Issues
Migrations using destination write blocking to destination clusters without users now fail with a helpful message prompting the customer to provision a user on the destination cluster.
Fixes an issue where
mongosyncpanicked after receiving twoSIGINT,SIGPIPE,SIGQUIT, orSIGTERMsignals in a row.
Other Changes
Adds and moves information about the ten largest collections from the
entered CEAtelemetry event to theentered collection copyevent.mongosyncdoes not support migrating into destination namespaces with pre-configured shard zone tags. For more information, see Sharded Clusters.Renames
mongosyncinternal databases to be consistent with other internal tooling.The
mongosync_reserved_for_internal_usedatabase is now__mdb_internal_mongosync.The embedded verifier's databases
mongosync_reserved_for_verification_{src,dst}_metadataare now__mdb_internal_mongosync_verifier_{src,dst}.Newly created capped collections during migration can cause
mongosyncto fail with error messagea capped collection was created on the source but capped collection handling is not enabled;.Removes the
enableUserWriteBlockingparameter from the/startAPI request.mongosyncnow manages write blocking on source and destination clusters based on your configuration. For more information, see Write Blocking.
Live Upgrades
Live upgrades to mongosync 1.20 are not supported.
Minimum Supported Version
For information on minimum supported versions, see MongoDB Server Version Compatibility.
For best performance, upgrade your source and destination clusters to the most recent MongoDB Server patch release prior to migration. For more information, see Upgrade to the Latest Self-Managed Patch Release of MongoDB.