DOCKER(1) Docker User Manuals DOCKER(1)

# [NAME](#NAME)

docker-image-rm - Remove one or more images

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

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](#EXAMPLES)

# [Removing an image](#Removing_an_image)

Here is an example of removing an image:

```
docker image rm fedora/httpd
```

# [OPTIONS](#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")

# [SEE ALSO](#SEE_ALSO)

[**docker-image(1)**](/man/os/docker-cli/docker-image.1)

Sep 2026 Docker Community

---

Document: docker-image-rm(1) from docker-cli 29.8.2-r0 (Chainguard OS)
Source: https://github.com/docker/cli