Restore Docker container

You can restore PMM Server either from a manual backup or from an automated backup volume that was created during migration to PMM v3.

Before proceeding with restoration, ensure you have either a manual backup or an automated backup volume to restore from.

Restore from manual backupRestore from automated migration backup

To restore the container from a manual backup:

1. Stop the container:

   docker stop pmm-server
   

2. Remove the container:

   docker rm pmm-server
   

3. Revert to the saved image:

   docker rename pmm-server-backup pmm-server
   

4. Change directory to the backup directory (e.g. pmm-data-backup):

   cd pmm-data-backup
   

5. Copy the data:

   docker run --rm -v $(pwd)/srv:/backup -v pmm-data:/srv -t percona/pmm-server:3 cp -r /backup/* /srv
   

6. Restore permissions:

   docker run --rm -v pmm-data:/srv -t percona/pmm-server:3 chown -R pmm:pmm /srv
   

7. Start the image:

   docker start pmm-server
   

To restore from an automated backup volume created during migration to PMM v3:

1. Stop the current PMM v3 container:

   docker stop pmm-server
   

2. Remove the container (optional):

   docker rm pmm-server
   

3. Start a PMM v2 container using your backup volume, replacing <backup-volume-name> with your PMM v2 backup volume name (e.g., pmm-data-2025-01-16-165135):

   docker run -d \
   -p 443:443 \
   --volume <backup-volume-name>:/srv \
   --name pmm-server \
   --restart always \
   percona/pmm-server:2.44.0
   

4. Verify that your PMM v2 instance is running correctly and all your data is accessible.

Finding your backup volume name

• Your backup volume name was displayed during the automated upgrade process.

• To list all available Docker volumes, use the following command, and look for volumes with names like pmm-data-YYYY-MM-DD-HHMMSS:

  docker volume ls