For AI agents: a documentation index is available at https://www.mongodb.com/docs/llms.txt — markdown versions of all pages are available by appending .md to any URL path.
Docs Menu

Release Notes for mongosync 1.22

This page describes changes and new features introduced in MongoDB Mongosync 1.22.

September 9, 2026

  • mongosync now performs a check of the available disk space on the destination cluster before it starts a migration. If the estimated space that the migration requires exceeds the available space, /start returns an InsufficientDestinationDiskSpace error and the migration does not start. To skip the check, such as in situations where the destination's file system storage does not accurately reflect available storage, set skipDiskSpaceCheck to true when you call /start. See Destination Disk Space and Request Body Parameters for more details.

  • Adds the ceaStage field to the /progress API response. The ceaStage field reports whether Change Event Application (CEA) is still draining the backlog of change events that accumulated during collection copy or is now applying change events that occurred after collection copy finished. See progress for more details.

  • Fixes an issue where lagTimeSeconds increased indefinitely when a migration included capped collections.
  • mongosync is no longer released for Amazon Linux 2, which reached end-of-life on June 30, 2026. To migrate from a host that runs Amazon Linux 2, use mongosync 1.21.

  • mongosync no longer provides x86-64 builds for macOS. mongosync provides only ARM64 builds for macOS.

  • mongosync is now built with Go 1.26.7.

Live upgrades to mongosync 1.22 are not supported.

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.