Remove PMM Server Docker container

Completely remove PMM Server from your Docker environment when you want to uninstall PMM Server, free up resources, or prepare for a clean installation.

Warning: Data loss

These steps will permanently delete your PMM Server container, all stored metrics data, and configuration. This action cannot be undone unless you have a backup.

Consider creating a backup before proceeding if you might need the data in the future.

Caution

These steps delete the PMM Server Docker image and any accumulated PMM metrics data.

To completely remove the container from your system:

1. Stop the running PMM Server container:

   docker stop pmm-server
   

2. Remove the container (preserving data volume):

   docker rm pmm-server
   

3. Remove the data volume containing all metrics and configuration:

   docker volume rm pmm-data
   

4. Remove the PMM Server Docker image:

   docker rmi $(docker images | grep "percona/pmm-server" | awk '{print $3}')
   

Verification

Verify that all PMM Server components have been removed:

# Check if the container is gone
docker ps -a | grep pmm-server

# Verify the volume is removed
docker volume ls | grep pmm-data

# Confirm the image is removed
docker images | grep percona/pmm-server

If the removal was successful, no results should be displayed for any of these commands.

Selective removal options

If you need to remove only specific components:

Remove container but keep data

This allows for future reinstallation without losing historical data:

docker stop pmm-server
docker rm pmm-server
# Do NOT remove the volume

Remove container and image but keep data

docker stop pmm-server
docker rm pmm-server
docker rmi $(docker images | grep "percona/pmm-server" | awk '{print $3}')
# Do NOT remove the volume

Related topics

• Backup PMM Server to create a backup before removal
• Restore PMM Server to restore from a backup if needed later
• Install PMM Server to reinstall PMM Server if needed