Upgrade PMM Server using Docker

Before you begin

{.power-number}

1. Create a backup before upgrading, as downgrades are not possible. Therefore, reverting to a previous version requires an backup made prior to the upgrade.

2. Verify your current PMM version: Check your current PMM version by navigating to PMM Configuration > Updates or by running the following command. If accessing remotely, replace localhost with the appropriate IP address or server name:

   sh docker exec -it pmm-server curl -ku admin:admin https://localhost/v1/version

Upgrade steps

{.power-number}

1. Stop the current container:

docker stop pmm-server

1. Back up your data.

2. Pull the latest image:

docker pull percona/pmm-server:3

1. Rename the original container:

docker rename pmm-server pmm-server-old

1. Run the new container:

docker run \
--detach \
--restart always \
--publish 443:8443 \
--volumes-from pmm-data \
--name pmm-server \
percona/pmm-server:3

1. After upgrading, verify that PMM Server is running correctly and all your data is accessible.

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