Installing Percona Distribution for MongoDB

Percona provides installation packages for the Percona Distribution for MongoDB in DEB and RPM formats for the most 64-bit Linux distributions.

Supported Distributions
  • Debian 9 (stretch)
  • Debian 10 (buster)
  • Ubuntu 16.04 (Xenial Xerus)
  • Ubuntu 18.04 LTS (Bionic Beaver)
  • Ubuntu 20.04 LTS (Focal Fossa)
  • Red Hat Enterprise Linux / CentOS 6
  • Red Hat Enterprise Linux / CentOS 7
  • Red Hat Enterprise Linux / CentOS 8

Percona Distribution for MongoDB is installed using the percona-release utility. This is the most straightforward way since percona-release enables the required repositories for you.

Percona provides two repositories for Percona Distribution for MongoDB. We recommend to install Percona Distribution for MongoDB from the Major Release repository (e.g. pdmdb-4.4) as it includes the latest version packages. Whenever a package is updated, the package manager of your operating system detects that and prompts you to update. As long as you update all Distribution packages at the same time, you can ensure that the packages you’re using have been tested and verified by Percona.

The Minor Release repository includes a particular minor release of the database and all of the packages that were tested and verified to work with that minor release (e.g. pdmdb-4.4.0). You may choose to install Percona Distribution for MongoDB from the Minor Release repository if you have decided to standardize on a particular release which has passed rigorous testing procedures and which has been verified to work with your applications. This allows you to deploy to a new host and ensure that you’ll be using the same version of all the Distribution packages, even if newer releases exist in other repositories.

The disadvantage of using a Minor Release repository is that you are locked in this particular release. When potentially critical fixes are released in a later minor version of the database, you will not be prompted for an upgrade by the package manager of your operating system. You would need to change the configured repository in order to install the upgrade.


The installation of Percona Distribution for MongoDB includes the following steps:

  1. Install the percona-release utility.
  2. Set up the Percona repository for the required version of Percona Distribution for MongoDB.
  3. Install the packages.

Run the following commands as root or by using the sudo command.

Install percona-release

See the Percona Software Repositories Documentation for installation instructions relevant to your operating system.

If you have previously installed percona-release, make sure it is updated to the latest version.

Set up Percona repository

As soon as percona-release is up-to-date, use the setup command to enable Percona repository for Percona Distribution for MongoDB (pdmdb-4.4).

$ sudo percona-release setup pdmdb-4.4

Hint

To enable a minor version repository (e.g. pdmdb-4.4.0), use the following command:

$ sudo percona-release setup pdmdb-4.4.0

Install packages

Install Percona Distribution for MongoDB components using the package manager of your operating system.

Install on Debian / Ubuntu

Use the following commands to install Percona Server for MongoDB and / or Percona Backup for MongoDB:

# Install the Percona Server for MongoDB package
$ apt-get install percona-server-mongodb
# Install the Percona Backup for MongoDB package
$ apt-get install percona-backup-mongodb

Install on Red Hat Enterprise Linux / CentOS

Use the following commands to install Percona Server for MongoDB and / or Percona Backup for MongoDB:

# Install the Percona Server for MongoDB package
$ yum install percona-server-mongodb
# Install the Percona Backup for MongoDB package
$ yum install percona-backup-mongodb

Uninstalling Percona Distribution for MongoDB

To uninstall Percona Distribution for MongoDB, remove the packages using the package manager of your operation system. Optionally, disable Percona repository.

See also

Uninstalling Percona Server for MongoDB:
Uninstalling Percona Backup for MongoDB
https://www.percona.com/doc/percona-backup-mongodb/uninstalling.html

Contact Us

For free technical help, visit the Percona Community Forum.
To report bugs or submit feature requests, open a JIRA ticket.
For paid support and managed or professional services, contact Percona Sales.