Skip to content
Percona Documentation

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 Now button on the PMM Home dashboard, you need to set up Watchtower alongside PMM Server during installation. Watchtower is a container monitoring tool that updates Docker containers to the latest version when triggered.

The PMM 3 Beta release will integrate Watchtower commands into the Easy-install script, allowing for a one-step setup of PMM alongside Watchtower. Until then, you can manually test the PMM installation by following the instructions using the instructions provided below.

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

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, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert