Skip to main content

Docker Remove

Managing resources efficiently is a crucial part of working with Docker. As you build and run containers, you'll accumulate unused resources that consume disk space and can make your environment cluttered. This guide will teach you how to effectively remove Docker containers, images, volumes, and networks.

Introduction​

Docker's architecture creates various objects as you work with it:

  • Containers: Running instances of images
  • Images: Templates used to create containers
  • Volumes: Persistent data storage outside of containers
  • Networks: Communication channels between containers

Over time, these objects accumulate and use system resources. Knowing how to properly remove them is essential for maintaining a clean Docker environment.

Removing Docker Containers​

Listing Containers​

Before removing containers, you need to know what's available:

bash
# List running containers
docker ps

# List all containers (running and stopped)
docker ps -a

Example output:

CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS                     PORTS     NAMES
a1b2c3d4e5f6   nginx:latest   "/docker-entrypoint.…"   10 minutes ago   Up 10 minutes              80/tcp    webserver
f6e5d4c3b2a1   redis:latest   "docker-entrypoint.s…"   3 hours ago      Exited (0) 2 hours ago               redis-cache

Removing a Specific Container​

To remove a specific container:

bash
# Remove by container ID or name
docker rm [CONTAINER_ID or NAME]

# Example
docker rm webserver

If the container is still running, you'll need to either stop it first or force removal:

bash
# Stop and then remove
docker stop webserver
docker rm webserver

# Force remove (not recommended for running containers)
docker rm -f webserver

Removing Multiple Containers​

You can remove multiple containers at once:

bash
# Remove multiple containers by ID or name
docker rm container1 container2 container3

# Remove all stopped containers
docker container prune

Example of removing all stopped containers with confirmation:

$ docker container prune
WARNING! This will remove all stopped containers.
Are you sure you want to continue? [y/N] y
Deleted Containers:
f6e5d4c3b2a1...
...
Total reclaimed space: 112.3MB

Automatically Removing Containers​

You can also create containers that automatically get removed after they stop:

bash
# Run a container that removes itself when stopped
docker run --rm nginx:latest

Removing Docker Images​

Docker images take up significant disk space. Removing unused images helps reclaim space.

Listing Images​

View your current images:

bash
# List all images
docker images

# Alternative command
docker image ls

Example output:

REPOSITORY   TAG       IMAGE ID       CREATED         SIZE
nginx        latest    eb4a57159180   2 weeks ago     187MB
redis        latest    7614ae9453d1   3 weeks ago     117MB
python       3.9       a5d7930b60cc   4 weeks ago     996MB

Removing a Specific Image​

Remove an image by its ID or repository:tag:

bash
# Remove by image ID
docker rmi eb4a57159180

# Remove by repository:tag
docker rmi nginx:latest

If the image is used by a container (running or stopped), you'll need to remove the container first or use force removal:

bash
# Force remove (use with caution)
docker rmi -f nginx:latest

Removing Unused Images​

Docker provides commands to remove unused images:

bash
# Remove dangling images (untagged images)
docker image prune

# Remove all unused images (not just dangling ones)
docker image prune -a

Example of removing unused images:

$ docker image prune -a
WARNING! This will remove all images without at least one container associated with them.
Are you sure you want to continue? [y/N] y
Deleted Images:
...
Total reclaimed space: 1.85GB

Removing Docker Volumes​

Volumes store persistent data, but unused volumes can accumulate over time.

Listing Volumes​

View your current volumes:

bash
# List all volumes
docker volume ls

Example output:

DRIVER    VOLUME NAME
local     db-data
local     7a2e50084e130...

Removing a Specific Volume​

bash
# Remove a volume by name
docker volume rm db-data

Removing Unused Volumes​

bash
# Remove all unused volumes
docker volume prune

Example:

$ docker volume prune
WARNING! This will remove all volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Deleted Volumes:
db-data
...
Total reclaimed space: 45.2MB

Removing Docker Networks​

Custom networks may be created for container communication. Cleaning up unused networks keeps your environment tidy.

Listing Networks​

bash
# List all networks
docker network ls

Example output:

NETWORK ID     NAME       DRIVER    SCOPE
012345abcdef   bridge     bridge    local
abcdef012345   mynetwork  bridge    local

Removing a Specific Network​

bash
# Remove a network by name or ID
docker network rm mynetwork

Removing Unused Networks​

bash
# Remove all unused networks
docker network prune

System-Wide Cleanup​

Docker provides a single command to clean up multiple resource types:

bash
# Remove unused containers, networks, images (dangling only), and volumes
docker system prune

# Include unused images in the cleanup
docker system prune -a

# Include volumes in the cleanup
docker system prune -a --volumes

Example of a full system prune:

$ docker system prune -a --volumes
WARNING! This will remove:
  - all stopped containers
  - all networks not used by at least one container
  - all images without at least one container associated with them
  - all build cache
  - all volumes not used by at least one container
Are you sure you want to continue? [y/N] y
Deleted Containers:
...
Deleted Networks:
...
Deleted Images:
...
Deleted Volumes:
...
Total reclaimed space: 15.6GB

Best Practices for Docker Resource Management​

  1. Regular Cleanup: Schedule regular maintenance to remove unused resources.
  2. Use --rm Flag: Use the --rm flag when running short-lived containers.
  3. Tag Management: Use meaningful tags for images and remove outdated versions.
  4. Named Volumes: Use named volumes for important data and anonymous volumes for temporary data.
  5. Check Space Usage: Monitor Docker's disk usage with docker system df.
bash
# Check Docker disk usage
docker system df

Example output:

TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          5         3         1.76GB    1.22GB (69%)
Containers      2         1         12.4MB    0B (0%)
Local Volumes   3         2         124MB     42.5MB (34%)
Build Cache     0         0         0B        0B

Troubleshooting Common Removal Issues​

Cannot Remove Running Container​

Problem: Error message "Cannot remove a running container"

Solution: Stop the container first or use force removal:

bash
docker stop container_id
docker rm container_id

Image In Use by Container​

Problem: Error message "conflict: unable to remove repository reference"

Solution: Remove the dependent containers first:

bash
# Find containers using the image
docker ps -a --filter ancestor=image_name

# Remove those containers
docker rm container_id

# Then remove the image
docker rmi image_id

Volume In Use​

Problem: Error message "volume is in use"

Solution: Remove the container using the volume:

bash
# Find containers using the volume
docker ps -a --filter volume=volume_name

# Remove those containers
docker rm container_id

# Then remove the volume
docker volume rm volume_name

Automation with Shell Scripts​

You can create simple shell scripts to automate cleanup tasks. Here's an example:

bash
#!/bin/bash

# Clean up all resources except important ones
echo "Stopping all containers..."
docker stop $(docker ps -a -q)

echo "Removing all containers except running ones..."
docker container prune -f

echo "Removing all images except ones tagged 'keep'..."
docker rmi $(docker images | grep -v 'keep' | awk '{if(NR>1) print $3}')

echo "Cleaning up volumes and networks..."
docker volume prune -f
docker network prune -f

echo "Cleanup complete!"

Summary​

Proper Docker resource management is essential for maintaining an efficient development environment. In this guide, you've learned:

  • How to remove containers, images, volumes, and networks
  • Best practices for managing Docker resources
  • Troubleshooting common removal issues
  • Automation techniques for cleanup

By regularly cleaning up your Docker environment, you'll save disk space, improve performance, and maintain a more organized workflow.

Further Resources​

Exercises​

  1. Create a shell script that removes all containers, images, volumes, and networks not currently in use.
  2. Set up a cron job to clean up dangling images and stopped containers every week.
  3. Modify the docker-compose.yml file of a project to automatically remove containers when they stop.
  4. Write a script that backs up important volumes before performing a system prune.
  5. Implement a tagging strategy for your Docker images to easily identify which ones should be kept and which can be removed.

If you spot any mistakes on this website, please let me know at [email protected]. I’d greatly appreciate your feedback! :)