Skip to content

Rate this page
Thanks for your feedback
Thank you! The feedback has been submitted.

Get free database assistance or contact our experts for personalized support.

Run Docker via the Easy-install script

The Easy-install script provides the simplest way to deploy PMM Server with Docker, handling all the necessary setup steps automatically.

Security best practice

Before running the script:

  • Download the installation script from the official Percona domain.

  • Review the script content to understand its actions.

  • Consider running the script with the --interactive flag to customize:

    • port mappings (default: 443 for HTTPS)
    • location where PMM Server stores its data
    • PMM Server version (specific version or latest)
    • additional configuration parameters (environment variables, resource limits)

Installation instructions

Linux or macOS

Download and install PMM Server using cURL or wget:

curl -fsSL https://www.percona.com/get/pmm | /bin/bash
wget -O - https://www.percona.com/get/pmm | /bin/bash
What does the script do?

This script does the following:

  • Installs Docker if it is not already installed on your system.
  • Stops and renames any currently running PMM Server Docker container from pmm-server to pmm-server-{timestamp}. This old pmm-server container is not a recoverable backup.
  • Pulls and runs the latest PMM Server Docker image.
  • Can run in Interactive mode to change the default settings:
   curl -fsSLO https://www.percona.com/get/pmm (or wget https://www.percona.com/get/pmm) 
   chmod +x pmm
   ./pmm --interactive

Docker installation issues

If you encounter Docker installation issues with the Easy-install script (such as ERROR: Unsupported distribution 'rocky' on Rocky Linux):

  1. Install Docker manually
  2. Run the Easy-install script above again

This two-step approach resolves most installation issues, especially on Rocky Linux where automatic installation may fail.

Next steps

After deploying PMM Server successfully, continue by setting up PMM Client:

Install PMM Client