Install on macOS

This version of the documentation is archived and no longer maintained. View the current documentation for up-to-date guidance on mongosync usage and instructions on how to upgrade your version of mongosync.

Overview

To configure MongoDB Cluster-to-Cluster Sync on macOS using a downloaded ZIP file, follow the steps on this page.

Cluster-to-Cluster Sync Version

This tutorial installs the latest version of mongosync.

Considerations

Platform Support

MongoDB Cluster-to-Cluster Sync 1.8 supports macOS 10.14 or later.

Version Requirements

Cluster-to-Cluster Sync supports synchronization between clusters. For information on MongoDB server version compatibility, see MongoDB Server Version Compatibility.

Install Cluster-to-Cluster Sync

Follow these steps to manually install Cluster-to-Cluster Sync from the ZIP file.

Download the ZIP file.

Download the Cluster-to-Cluster Sync ZIP file from the following link:

➤ MongoDB Download Center

In the Version dropdown, select the version of Cluster-to-Cluster Sync to download.
In the Platform dropdown, select your macOS platform.
In the Package dropdown, select zip.
Click Download.

Unzip the files from the downloaded archive.

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

unzip mongosync-*.zip

Ensure the binary is in a directory listed in your `PATH` environment variable.

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
```

Back

Linux

Verify Packages