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.

Install on macOS

To configure MongoDB Mongosync on macOS using a downloaded ZIP file, follow the steps on this page.

This tutorial installs the latest version of mongosync.

MongoDB Mongosync 1.20 supports macOS 10.14 or later.

Mongosync supports synchronization between clusters. For information on MongoDB server version compatibility, see MongoDB Server Version Compatibility.

Follow these steps to manually install Mongosync from the ZIP file.

1

Download the Mongosync ZIP file from the following link:

➤ MongoDB Download Center

  1. In the Version dropdown, select the version of Mongosync to download.

  2. In the Platform dropdown, select your macOS platform.

  3. In the Package dropdown, select zip.

  4. Click Download.

2

To unzip mongosync, use the unzip command in a system shell:

unzip mongosync-*.zip
3

The mongosync binary is in the bin/ directory of the unpacked tarball. To add the location of the mongosync binary to your PATH, do one of the following:

  • Copy the binary into a directory listed in your PATH variable, such as /usr/local/bin. (Update /path/to/mongosync/bin to reflect the location where you extracted the tar file.)

    sudo cp /path/to/mongosync/bin/mongosync /usr/local/bin/
  • Create symbolic links to the mongosync binary from a directory such as /usr/local/bin that is already in your PATH. (Update /path/to/mongosync/bin to reflect the location where you extracted the tar file.)

    sudo ln -s /path/to/mongosync/bin/mongosync /usr/local/bin/mongosync

Every release artifact of Mongosync contains a Software Bill of Materials (SBOM) report and a static analysis report. Both reports are JSON files named after the artifact that contains them:

  • The SBOM report uses the CycloneDX format and ends with .bom.json.

  • The static analysis report uses the SARIF format and ends with .sarif.json.

The reports are located at the top level of the archive. For example, the mongosync-macos-arm-arm64-1.20.0.zip archive contains:

  • mongosync-macos-arm-arm64-1.20.0.bom.json

  • mongosync-macos-arm-arm64-1.20.0.sarif.json