A Guide to Installing Percona Monitoring and Management (PMM)2 For the First Time
Percona Monitoring and Management (PMM)2 is a free and open-source platform that helps you monitor and optimize the performance of your MySQL, MongoDB, and PostgreSQL databases. PMM2 provides you with dashboards, metrics, alerts, and query analytics to help you troubleshoot issues and improve your database efficiency.
In this article, we will show you how to install PMM2 for the first time on a Linux server using Docker. We will also show you how to add your database instances to PMM2 for monitoring.
Before you begin, make sure you have the following:
A Linux server with Docker installed and running. You can follow this guide to install Docker on your server.
A MySQL, MongoDB, or PostgreSQL database instance that you want to monitor with PMM2. You can use any version of these databases that is supported by PMM2. You can check the compatibility matrix here.
A user account with root or sudo privileges on your Linux server.
A web browser to access the PMM2 web interface.
Step 1: Pulling the PMM2 Docker Image
The first step is to pull the PMM2 Docker image from the Docker Hub repository. To do this, run the following command on your Linux server:
sudo docker pull percona/pmm-server:2
This will download the latest version of PMM2 to your server. You can check the available versions of PMM2 here.
Step 2: Creating a Data Container for PMM2
The next step is to create a data container for PMM2. A data container is a Docker container that stores the persistent data for PMM2, such as configuration files, metrics, and backups. To create a data container for PMM2, run the following command on your Linux server:
sudo docker create \\
--volume /srv \\
--name pmm-data \\
This will create a data container named pmm-data using the PMM2 image. The /srv volume will store the data for PMM2.
Step 3: Running the PMM2 Server Container
The final step is to run the PMM2 server container using the data container we created in the previous step. To do this, run the following command on your Linux server:
sudo docker run \\
--restart always \\
--publish 80:80 \\
--publish 443:443 \\
--volumes-from pmm-data \\
--name pmm-server \\
This will run the PMM2 server container named pmm-server using the pmm-data container for data storage. The --publish options will expose ports 80 and 443 on your Linux server for accessing the PMM2 web interface. The --restart option will ensure that the PMM2 server container restarts automatically if it stops or crashes.
Step 4: Accessing the PMM2 Web Interface
Now that you have installed PMM2 on your Linux server using Docker, you can access the PMM2 web interface by opening your web browser and navigating to http://. You should see a screen like this:
The default username and password for logging in are both admin. You can change them later from the Settings menu.