docker image rm

Estimated reading time: 2 minutes

Description

Remove one or more images

Usage

docker image rm [OPTIONS] IMAGE [IMAGE...]

Options

Name, shorthand Default Description
--force, -f false Force removal of the image
--no-prune false Do not delete untagged parents

Parent command

Command Description
docker image Manage images
Command Description
docker image build Build an image from a Dockerfile
docker image history Show the history of an image
docker image import Import the contents from a tarball to create a filesystem image
docker image inspect Display detailed information on one or more images
docker image load Load an image from a tar archive or STDIN
docker image ls List images
docker image prune Remove unused images
docker image pull Pull an image or a repository from a registry
docker image push Push an image or a repository to a registry
docker image rm Remove one or more images
docker image save Save one or more images to a tar archive (streamed to STDOUT by default)
docker image tag Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE

Extended description

Removes one or more images from the host node. This does not remove images from a registry. You cannot remove an image of a running container unless you use the -f option. To see all images on a host use the docker image ls command.

EXAMPLES

Removing an image

Here is an example of removing an image:

docker image rm fedora/httpd

Examples

Removing an image

Here is an example of removing an image:

$ docker image rm fedora/httpd
chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page ● Request docs changes ● Get support
Rate this page: