Installing DEB packages using apt-get

If you are running a DEB-based Linux distribution, use the apt package manager to install PMM Client from the official Percona software repository.

Percona provides .deb packages for 64-bit versions of the following distributions:

  • Debian 8 (jessie)
  • Debian 9 (stretch)
  • Debian 10 (buster)
  • Ubuntu 16.04 LTS (Xenial Xerus)
  • Ubuntu 18.04 (Bionic Beaver)
  • Ubuntu 20.04 (Focal Fossa)


PMM Client should work on other DEB-based distributions, but it is tested only on the platforms listed above.

To install the PMM Client package, complete the following procedure. Run the following commands as root or by using the sudo command:

  1. Configure Percona repositories using the percona-release tool. First you’ll need to download and install the official percona-release package from Percona:

    sudo dpkg -i percona-release_latest.generic_all.deb


    If you have previously enabled the experimental or testing Percona repository, don’t forget to disable them and enable the release component of the original repository as follows:

    sudo percona-release disable all
    sudo percona-release enable original release

    See percona-release official documentation for details.

  2. Install the pmm2-client package:

    sudo apt-get update
    sudo apt-get install pmm2-client
  3. Once PMM Client is installed, run the sudo pmm-admin config command with your PMM Server IP address to register your Node within the Server:

    pmm-admin config --server-insecure-tls --server-url=https://admin:admin@<IP Address>:443

    You should see the following:

    Checking local pmm-agent status...
    pmm-agent is running.
    Registering pmm-agent on PMM Server...
    Configuration file /usr/local/percona/pmm-agent.yaml updated.
    Reloading pmm-agent configuration...
    Configuration reloaded.

Table Of Contents

Previous topic

Installing Clients

Next topic

Installing RPM packages using yum