---
name: "docker-image-rm"
section: "1"
platform: "linux"
package: "docker"
version: "1:29.9.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/docker-image-rm"
---

# docker-image-rm(1)

Remove one or more images

## NAME

docker-image-rm - Remove one or more images

## SYNOPSIS

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

## 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

## 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")

## SEE ALSO

**[docker-image(1)](/docker-image/1.md)**