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 manually using binaries

This method allows you to install PMM Client using pre-compiled binary packages on a wide range of Linux distributions, for both x86_64 and ARM64 architectures.

Installing from binaries offers these advantages:

  • Supports Linux distributions not covered by package managers
  • Doesn’t require package managers
  • Allows installation without root permissions (unique to this method)
  • Provides complete control over the installation location

Version information

The commands below are for the latest PMM release. If you want to install a different release, make sure to update the commands with your required version number.

Choose your installation path

Select the appropriate instructions based on your access level:

To install with root/administrator privileges:

  1. Download the PMM Client package for your architecture:

    wget https://downloads.percona.com/downloads/pmm3/3.3.0/binary/tarball/pmm-client-3.3.0-x86_64.tar.gz

    wget https://downloads.percona.com/downloads/pmm3/3.3.0/binary/tarball/pmm-client-3.3.0-aarch64.tar.gz

  2. Download the corresponding checksum file to verify integrity:

    wget https://downloads.percona.com/downloads/pmm3/3.3.0/binary/tarball/pmm-client-3.3.0-x86_64.tar.gz.sha256sum

    wget https://downloads.percona.com/downloads/pmm3/3.3.0/binary/tarball/pmm-client-3.3.0-aarch64.tar.gz.sha256sum

  3. Verify the download:

    sha256sum -c pmm-client-3.3.0-x86_64.tar.gz.sha256sum

    sha256sum -c pmm-client-3.3.0-aarch64.tar.gz.sha256sum

  4. Unpack the package and move into the directory:

    tar xfz pmm-client-3.3.0-x86_64.tar.gz && cd pmm-client-3.3.0

    tar xfz pmm-client-3.3.0-aarch64.tar.gz && cd pmm-client-3.3.0

  5. Set the installation directory:

    export PMM_DIR=/usr/local/percona/pmm

  6. Run the installer:

    ./install_tarball

  7. Update your PATH:

    PATH=$PATH:$PMM_DIR/bin

  8. Set up the agent:

    pmm-agent setup --config-file=/usr/local/percona/pmm/config/pmm-agent.yaml --server-address=192.168.1.123 --server-insecure-tls --server-username=admin --server-password=admin

  9. Run the agent:

    pmm-agent --config-file=${PMM_DIR}/config/pmm-agent.yaml

  10. Open a new terminal and verify the installation:

    pmm-admin status

Follow these steps for environments where you don’t have root access:

  1. Download the PMM Client package for your architecture:

    wget https://downloads.percona.com/downloads/pmm3/3.3.0/binary/tarball/pmm-client-3.3.0-x86_64.tar.gz

    wget https://downloads.percona.com/downloads/pmm3/3.3.0/binary/tarball/pmm-client-3.3.0-aarch64.tar.gz

  2. Download the corresponding checksum file to verify integrity:

    wget https://downloads.percona.com/downloads/pmm3/3.3.0/binary/tarball/pmm-client-3.3.0-x86_64.tar.gz.sha256sum

    wget https://downloads.percona.com/downloads/pmm3/3.3.0/binary/tarball/pmm-client-3.3.0-aarch64.tar.gz.sha256sum

  3. Verify the download:

    sha256sum -c pmm-client-3.3.0-x86_64.tar.gz.sha256sum

    sha256sum -c pmm-client-3.3.0-aarch64.tar.gz.sha256sum

  4. Unpack the package and move into the directory:

    tar xfz pmm-client-3.3.0-x86_64.tar.gz && cd pmm-client-3.3.0

    tar xfz pmm-client-3.3.0-aarch64.tar.gz && cd pmm-client-3.3.0

  5. Set the installation directory:

    export PMM_DIR=YOURPATH

    Replace YOURPATH with a path where you have required access.

  6. Run the installer:

    ./install_tarball

  7. Update your PATH:

    PATH=$PATH:$PMM_DIR/bin

  8. Set up the agent:

    pmm-agent setup --config-file=${PMM_DIR}/config/pmm-agent.yaml --server-address=192.168.1.123 --server-insecure-tls --server-username=admin --server-password=admin --paths-tempdir=${PMM_DIR}/tmp --paths-base=${PMM_DIR}

  9. Run the agent:

    pmm-agent --config-file=${PMM_DIR}/config/pmm-agent.yaml

  10. Open a new terminal and verify the installation:

    pmm-admin status

Tip for quick installation

For a quick installation:

  • Download the PMM Client tar.gz file
  • Extract it
  • Run ./install_tarball (or with -u flag to preserve existing config during upgrades)