docker-image-rm(1)

docker-image-rm1

Remove one or more images

Usage

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

Overview

Removes (and un-tags) one or more images from the host node. If an image has multiple tags, using this command with the tag as a parameter only removes the tag. If the tag is the only one for the image, both the image and the tag are removed.

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

Options

-f, --force[=false]
Force removal of the image

--no-prune[=false]
Do not delete untagged parents

--platform=[]
Remove only the given platform variant. Formatted as "os[/arch[/variant]]" (e.g., "linux/amd64")

Releases

5 releases since Debian 10 (Buster); the text changed 4 times.

  1. 10
  2. 11
  3. 12
  4. 13
  5. Arch

From docker 1:29.9.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.