Remove a Docker Image

The short answer

To remove and un-tag a single Docker image from your local machine, you can use the docker rmi command followed the the identifier of the image you want to remove:

$ docker rmi <image_id>

Note that you will first need to stop and remove all the containers currently using this image in order to be able to remove it.

You can learn more about this by reading our article on how to remove all stopped Docker containers.

Easily retrieve this command using Warp’s AI Command Search

If you’re using Warp as your terminal, you can easily retrieve this command using the Warp AI Command Search feature:

Entering docker remove image in the AI Command Search will prompt an docker command that can then quickly be inserted into your shell by doing CMD+ENTER.

Removing an image from the local machine

A Docker image can be removed using either its short or long identifier, its tag, or its digest. To get this information, you can run the docker images command, which will list all the locally downloaded images:

$ docker images

You can then use one of the methods described below to remove one or more images. Alternatively, you can also read our article on how to remove all Docker images at once.

Removing an image using its tag

A tag is a string of characters used to identify a specific version of an image (e.g. latest, v1.0).

To remove an image based on its tag, you can use the following syntax:

$ docker rmi <image:tag>

For example, the following command will remove the mysql image version 8:

$ docker rmi mysql:8

Note that if an image has one or more tags referencing it, you must remove all of them before the image is removed.

Removing an image using its digest

A Docker image digest is an immutable identifier created during the build time of the image.

Since a digest cannot be altered or tampered with, unlike a name or tag, it is sometimes preferable to use it in order to prevent the accidental removal of unwanted images, especially when working with scripts or automation.

To remove a Docker image using its digest, you can use the following syntax:

$ docker rmi <image>@<digest>

For example, the following command will remove the mysql image based on its digest value:

$ docker rmi mysql@sha256:15f069202c46cf861ce429423ae3f8dfa6423306fbf399eaef36094ce30dd75c

Note that to list all images including their digest, you can use the docker images --digests command.

Forcing the image removal

To force the removal of a Docker image, regardless of whether it is currently used by containers or has multiple tags associated with it, you can use the docker rmi command with the -f flag (short for force) as follows:

$ docker rmi -f <image>

Note that this command should be used with caution as it may provoke the unexpected disruption of running applications.

Removing an image from a Docker registry

To remove an image from an online Docker registry, you must first authentication to the registry using the docker login command:

$ docker login <registry_url>

List all the images present in the registry using the docker search command:

$ docker search <registry_url>

And finally, run the docker rmi command using the following syntax:

$ docker rmi <registry_url>/<image>:<tag>

For example:

$ docker rmi docker.io/library/nginx:latest

Removing an image from Artifactory

To remove a Docker image from Artifactory, you can use the following curl command:

$ curl -u <username>:<password> -X DELETE "<artifactory_url>/artifactory/<repository>/<image>:<tag>"

Where:

• username is your Artifactory username.
• password is your Artifactory password.
• artifactory\_url is the URL of your Artifactory instance.
• repository is the name of the repository where the Docker image is stored.
• image is the name of the Docker image you want to remove.
• tag is the tag of the Docker image you want to remove.