Install on macOS

This documentation refers to an outdated version of mongosync. View the current documentation for up-to-date guidance on mongosync and instructions on how to upgrade to the latest version.

Overview

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

Mongosync Version

This tutorial installs the latest version of mongosync.

Considerations

Platform Support

MongoDB Mongosync 1.9 supports macOS 10.14 or later.

Version Requirements

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

Install Mongosync

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

Download the ZIP file.

Download the Mongosync ZIP file from the following link:

➤ MongoDB Download Center

In the Version dropdown, select the version of Mongosync 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

macOS