Install Percona ClusterSync for MongoDB from Percona repositories

To install the software from Percona repositories means to subscribe to them. Percona provides the percona-release repository management tool. It automatically enables the required repository so that you can install and update both Percona ClusterSync for MongoDB packages and required dependencies smoothly.

Before you start

Check the following resources:

• system requirements
• known limitations
• supported operating systems .

Data migration is a resource-intensive task. Therefore, we recommend installing PCSM on the instance closest to the target to reduce the network lag as much as possible.s

Procedure

Warning: Run the following commands as root or via the sudo command.

On Debian and Ubuntu On RHEL and derivatives On Amazon Linux 2023

1. Install percona-release:

   1. Install the curl download utility if it’s not installed already:

      $ sudo apt update
      $ sudo apt install curl 
      

   2. Download the percona-release repository package:

      $ curl -O https://repo.percona.com/apt/percona-release_latest.generic_all.deb
      

   3. Install the downloaded repository package and its dependencies using apt:

      $ sudo apt install gnupg2 lsb-release ./percona-release_latest.generic_all.deb
      

   4. Refresh the local cache to update the package information:

      $ sudo apt update
      

2. Enable the repository

   $ sudo percona-release enable pcsm release
   

3. Install the package:

   $ sudo apt install percona-clustersync-mongodb
   

1. Install percona-release:

   Run the following command as the root user or with sudo privileges:

   $ sudo yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
   

2. Enable the repository

   $ sudo percona-release enable pcsm release
   

3. Install the package:

   $ sudo yum install percona-clustersync-mongodb
   

1. Install percona-release:

   Run the following command as the root user or with sudo privileges:

   $ sudo yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
   

2. Enable the repository

   $ sudo percona-release enable pcsm release
   

3. Install the package:

   $ sudo yum install percona-clustersync-mongodb
   

Congratulations! You have successfully installed Percona ClusterSync for MongoDB. Now you must connect it to source and target MongoDB deployments.

Next steps

Configure authentication

---

Last update: January 13, 2026
Created: January 13, 2026