Install PMM Server with Docker container¶

This section provides instructions for running PMM Server with Docker based on the PMM Docker image.

Running PMM Server with Watchtower¶

To enable PMM Server upgrades via the Upgrade page and the Upgrade Now button on the Home dashboard, you must configure Watchtower during the PMM Server installation. Watchtower is a container monitoring tool that automatically updates Docker containers to their latest version when triggered.

The Easy-install script script includes Watchtower commands, allowing for a one-step setup of PMM alongside Watchtower.

You can also install PMM 3 manually, following the instructions below.

Installing PMM Server manually¶

Before starting the installation, review the installation prerequisites below and choose a method to run PMM Server with Docker based on your preferred data storage option:

Manual installation prerequisites¶

Install Docker version 17.03 or higher.
Ensure your CPU (and any virtualization layer you may be using) supports x86-64-v2.
Install Watchtower to automatically update your containers with the following considerations:
- Ensure Watchtower is only accessible from within the Docker network or local host to prevent unauthorized access and enhance container security.
- Configure network settings to expose only the PMM Server container to the external network, keeping Watchtower isolated within the Docker network.
- Grant Watchtower access to the Docker socket to monitor and manage containers effectively, ensuring proper security measures are in place to protect the Docker socket.
- Verify that both Watchtower and PMM Server are on the same network, or ensure PMM Server can connect to Watchtower for communication. This network setup is essential for PMM Server to initiate updates through Watchtower.

Run Docker container¶

Summary

Pull the Docker image.
Copy it to create a persistent data container.
Run the image.
Open the PMM UI in a browser.

Key points

To disable the Home Dashboard PMM Upgrade panel you can either add -e DISABLE_UPDATES=true to the docker run command (for the life of the container) or navigate to PMM → PMM Settings → Advanced Settings and disable “Check for Updates” (can be turned back on by any admin in the UI).
Eliminate browser certificate warnings by configuring a trusted certificate.
You can optionally enable an (insecure) HTTP connection by adding --publish 80:80 to the docker run command. However, running PMM insecure is not recommended. You should also note that PMM Client requires TLS to communicate with the server, only working on a secure port.

Get expert help¶

If you need assistance, you can find comprehensive and free database knowledge on our community forum or blog posts. For professional support and services, contact our Percona Database Experts.

Community Forum Get a Percona Expert