Skip to content
PERCONA MONITORING AND MANAGEMENT DOCUMENTATION

For help, click the link below to get free database assistance or contact our experts for personalized support.

Get help from Percona

Install PMM Client with Percona repositories

Percona Monitoring and Management (PMM) Client can be installed using standard Linux package managers. You can choose between automated repository setup or manual package download options.

Supported architectures and platforms

PMM Client supports:

  • Architectures: x86_64 (AMD64) and ARM64 (aarch64)
  • Operating systems:
    • Red Hat/CentOS/Oracle Linux 8 and 9
    • Debian 11 (Bullseye) and 12 (Bookworm)
    • Ubuntu 20.04 (Focal), 22.04 (Jammy), and 24.04 (Noble)
    • Amazon Linux 2023

The package manager will automatically select the appropriate version for your system architecture.

Installation options

Choose one of these installation methods:

Quick installation using Percona repositories

This method configures the Percona repository on your system and installs PMM Client using your distribution’s package manager.

Tip

If you have used percona-release before, disable and re-enable the repository: 

percona-release disable all
percona-release enable pmm3-client

On Debian or Red Hat Linux, install percona-release and use a Linux package manager (apt/dnf) to install PMM Client.

To install PMM Client:

  1. Configure repositories: 
    wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
dpkg -i percona-release_latest.generic_all.deb
  2. Enable pmm3-client repository: 
    percona-release enable pmm3-client

  3. Install the PMM Client package: !!! hint “Root permissions required” The installation commands below require root privileges. Use sudo if you’re not running as root.

    apt update
apt install -y pmm-client

  4. Verify the installation by checking the PMM Client version: 

    pmm-admin --version

  5. Register the node.

To install PMM Client:

  1. Configure repositories: 
    yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
  2. Enable pmm3-client repository: 
    percona-release enable pmm3-client
  3. Install the PMM Client package: 
    yum install -y pmm-client
  4. Verify the installation by checking the PMM Client version: 
    pmm-admin --version
  5. Register the node.

Manual package download

If you prefer to download and install the packages manually without configuring repositories:

  1. Visit the PMM download page page.
  2. Select PMM 3 and choose specific version (usually the latest), under Select Platform, select the item matching your software platform and architecture (x86_64 or ARM64).

  3. Click the link in the Package Download Option section and download the package file or copy the link and use wget to download it.

    dpkg -i *.deb

    dnf localinstall *.rpm