Removing images in Docker - Commands & Configuration

Introduction

Sometimes your computer fills up with old or unused Docker images. Removing these images frees up space and keeps your system clean.

When you have images that you no longer use and want to free disk space

When you want to remove a broken or corrupted image to fix Docker issues

When cleaning up after testing multiple versions of an app image

When you want to remove dangling images that have no tags

When preparing your system before pulling fresh images

Commands

List all Docker images on your system so you can see their IDs and names before removing any.

Terminal

docker images

Expected Output

REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE

nginx               latest              4bb46517cac3        2 weeks ago         133MB

hello-world         latest              fce289e99eb9        3 months ago        13.3kB

Remove the Docker image with the ID 4bb46517cac3 to free up space and clean unused images.

Terminal

docker rmi 4bb46517cac3

Expected Output

Untagged: nginx:latest

Deleted: sha256:4bb46517cac3a1b2c3d4e5f67890123456789abcdef0123456789abcdef012345

Remove all dangling images (images not tagged or used by any container) to clean up space quickly.

Terminal

docker image prune -f

Expected Output

Deleted Images:

untagged: <none>:<none>

Total reclaimed space: 50MB

→

-f - Force removal without asking for confirmation

Key Concept

If you remember nothing else, remember: use 'docker rmi' with the image ID or name to remove specific images and 'docker image prune' to clean up unused dangling images.

Common Mistakes

Trying to remove an image that is still used by a running container

Docker will refuse to remove images that are in use, causing an error.

Stop and remove containers using the image before removing the image.

Using 'docker rmi' without specifying the correct image ID or name

The command will fail because Docker cannot find the image to remove.

Run 'docker images' first to get the exact image ID or name.

Not using the '-f' flag with 'docker image prune' and expecting it to run without confirmation

The command will prompt for confirmation and wait, which can interrupt scripts.

Add '-f' to force prune without confirmation in automated scripts.

Summary

Use 'docker images' to list all images and find the image ID or name.

Use 'docker rmi IMAGE_ID' to remove a specific image by its ID.

Use 'docker image prune -f' to remove all dangling images quickly.

Practice

1. What is the basic Docker command to remove an image from your system?

easy

A. docker delete <image_name_or_id>

B. docker rmi <image_name_or_id>

C. docker remove image <image_name_or_id>

D. docker rm <image_name_or_id>

Solution

1. Step 1: Understand Docker image removal command

   The correct command to remove Docker images is docker rmi. It stands for 'remove image'.

2. Step 2: Identify the correct syntax

   The command requires the image name or ID after docker rmi to specify which image to remove.

3. Final Answer:

   docker rmi <image_name_or_id> -> Option B

4. Quick Check:

   Remove image = docker rmi [OK]

Hint: Use 'docker rmi' to remove images quickly [OK]

Common Mistakes:

• Using 'docker rm' which removes containers, not images
• Typing 'docker delete' which is not a valid Docker command
• Confusing image removal with container removal commands

2. Which of the following is the correct syntax to force remove a Docker image named myapp:latest?

easy

A. docker rmi -f myapp:latest

B. docker rmi -force myapp:latest

C. docker rmi -rf myapp:latest

D. docker rmi --f myapp:latest

Solution

1. Step 1: Identify the correct flag for force removal

   The short flag -f is used to force remove images in Docker.

2. Step 2: Confirm the correct command syntax

   The correct command is docker rmi -f myapp:latest. Other options use invalid flags like -rf, -force, or --f.

3. Final Answer:

   docker rmi -f myapp:latest -> Option A

4. Quick Check:

   Force remove = docker rmi -f [OK]

Hint: Use '-f' to force remove images safely [OK]

Common Mistakes:

• Using incorrect flag like '-rf', '-force' or '--f'
• Confusing force flag with other options
• Misspelling the flag causing command failure

3. What will be the output of the command docker rmi 123abc456def if the image ID 123abc456def exists and is not used by any container?

medium

A. Image removed but container still running

B. Error: image is being used by a running container

C. No such image: 123abc456def

D. Untagged: 123abc456def
Deleted: sha256:123abc456def...

Solution

1. Step 1: Check if image exists and is unused

   If the image ID exists and no container uses it, Docker removes it cleanly.

2. Step 2: Understand Docker rmi output

   The command outputs lines showing the image is untagged and deleted with its sha256 hash.

3. Final Answer:

   Untagged: 123abc456def Deleted: sha256:123abc456def... -> Option D

4. Quick Check:

   Image removed cleanly = Untagged: 123abc456def Deleted: sha256:123abc456def... [OK]

Hint: If image unused, 'docker rmi' shows untagged and deleted [OK]

Common Mistakes:

• Assuming image removal works if container uses it
• Expecting no output on successful removal
• Confusing image ID with container ID

4. You run docker rmi myimage but get the error: Error response from daemon: conflict: unable to delete image (must be forced) - image is being used by running container. What should you do to fix this?

medium

A. Use docker rm myimage to remove the image

B. Run docker rmi myimage again without changes

C. Stop the running container using the image, then run docker rmi myimage again

D. Restart Docker daemon and try again

Solution

1. Step 1: Understand the error meaning

   The error says the image is used by a running container, so Docker won't remove it without force.

2. Step 2: Stop the container using the image

   You must stop or remove the container using the image before removing the image itself.

3. Final Answer:

   Stop the running container using the image, then run docker rmi myimage again -> Option C

4. Quick Check:

   Stop container before removing image [OK]

Hint: Stop containers using image before removal [OK]

Common Mistakes:

• Trying to remove image without stopping containers
• Using 'docker rm' which removes containers, not images
• Restarting Docker daemon unnecessarily

5. You want to remove all Docker images that are not used by any container to free up space. Which command will safely do this?

hard

A. docker image prune -a

B. docker rmi $(docker images -q)

C. docker rmi -f $(docker ps -aq)

D. docker container prune

Solution

1. Step 1: Understand the goal

   You want to remove all unused images, but keep images used by containers.

2. Step 2: Identify the correct command

   docker image prune -a removes all unused images safely without affecting running containers.

3. Step 3: Analyze other options

   docker rmi $(docker images -q) tries to remove all images, including used ones, causing errors.
   docker rmi -f $(docker ps -aq) is invalid because docker ps -aq lists containers, not images.
   docker container prune removes stopped containers, not images.

4. Final Answer:

   docker image prune -a -> Option A

5. Quick Check:

   Remove unused images safely = docker image prune -a [OK]

Hint: Use 'docker image prune -a' to clean unused images [OK]

Common Mistakes:

• Trying to remove all images forcibly causing errors
• Confusing container prune with image prune
• Using container IDs instead of image IDs in commands