Skip to content

Installation

It is recommended to install Percona software using the corresponding package manager for your system:

Find information about supported platforms on the Percona Release Lifecycle Overview.

Install on Debian and Ubuntu

If you are running a DEB-based distribution, such as Debian or Ubuntu, use the apt package manager to install the percona-release official package:

Prerequisites

In Linux distributions that rely on dpkg, the packages wget, gnupg2, curl and lsb-release are already installed. However, these packages may be missing from Docker base images. In this case, install them manually before running dpkg:

sudo apt update
sudo apt install -y wget gnupg2 curl lsb-release 
  1. Fetch the repository package:

    wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
    
  2. Install the downloaded repository package with dpkg:

    sudo dpkg -i percona-release_latest.generic_all.deb
    
  3. After installation, the Percona repositories are available. You can check the repository setup for the Percona original release list in the /etc/apt/sources.list.d/percona-original-release.list file.

    Note

    If you have enabled another repository, the file name is different.

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

    sudo apt update
    

Dealing with issues

During the installation, dpkg may fail due to unsatisfied dependencies.

dpkg: error processing package percona-release (--install):
installed percona-release package post-installation script subprocess returned error exit status 255

In this case, run the following command:

sudo apt install --fix-broken

Next steps: run the percona-release command to set up the repository that contains the Percona product that you intend to install.

Install on Red Hat Enterprise Linux and CentOS

If you are running an RPM-based distribution, such as Red Hat Enterprise Linux or CentOS, use the yum package manager to install percona-release. Run the following command as the root user or with sudo:

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

Next steps: run the percona-release command to set up the repository that contains the Percona product that you intend to install.


Last update: 2022-01-11
Back to top