Install on Linux

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 Linux using a downloaded .tgz tarball, follow the steps on this page.

Mongosync is available on select platforms.

Mongosync Version

This tutorial installs the latest version of mongosync.

Considerations

Platform Support

Mongosync is available on the following Linux operating systems:

Amazon Linux 2
Red Hat Enterprise Linux (RHEL) 7
Red Hat Enterprise Linux (RHEL) 8
Ubuntu 18.04
Ubuntu 20.04

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 .tgz.

Download the tarball.

Download the Mongosync .tgz tarball from the following link:

➤ MongoDB Download Center

In the Version dropdown, select the version of Mongosync to download.
In the Platform dropdown, select your Linux platform.
In the Package dropdown, select shell (tgz).
Click Download.

Extract the files from the downloaded archive.

To extract mongosync, use the tar command in a system shell:

tar -zxvf mongosync-*.tgz

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

About mongosync

macOS