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, Docker image, all stored metrics data, and configuration. This action cannot be undone unless you have a backup.

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

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. If you successfully removed everything, these commands should return no results:

# 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

Selective removal options

If you need to remove only specific components:

Remove container but keep dataRemove container and image 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

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