Install Percona Link 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 Link for MongoDB packages and required dependencies smoothly.

Supported operating systems

Percona Link for MongoDB is available on the following operating systems:

• Debian 11
• Debian 12
• Ubuntu 20.04 (Focal Fossa)
• Ubuntu 22.04 (Jammy Jellyfish)
• Ubuntu 24.04 (Noble Numbat)
• Red Hat Enterprise Linux and compatible derivatives 8 and 9
• Amazon Linux 2023

Before you start

Check the system requirements and known limitations.

Data migration is a resource-intensive task. Therefore, we recommend installing PLM 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 plm release
   

3. Install the package:

   $ sudo apt install percona-link-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 plm release
   

3. Install the package:

   $ sudo yum install percona-link-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 plm release
   

3. Install the package:

   $ sudo yum install percona-link-mongodb
   

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

Next steps

Configure authentication

---

Last update: June 5, 2025
Created: June 5, 2025