0a0dd116 |
% DOCKER(1) Docker User Manuals |
b07f1938 |
% Docker Community
% JUNE 2014 |
0a0dd116 |
# NAME |
b07f1938 |
docker-rmi - Remove one or more images |
0a0dd116 |
# SYNOPSIS |
b07f1938 |
**docker rmi** |
e6115a6c |
[**-f**|**--force**] |
a2b529ea |
[**--help**] |
e6115a6c |
[**--no-prune**] |
b07f1938 |
IMAGE [IMAGE...] |
0a0dd116 |
# DESCRIPTION
|
b6d55ebc |
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 images** command. |
0a0dd116 |
# OPTIONS
**-f**, **--force**=*true*|*false* |
b07f1938 |
Force removal of the image. The default is *false*.
|
a2b529ea |
**--help**
Print usage statement
|
b07f1938 |
**--no-prune**=*true*|*false*
Do not delete untagged parents. The default is *false*. |
0a0dd116 |
# EXAMPLES
## Removing an image
|
3eea6f75 |
Here is an example of removing an image: |
0a0dd116 |
docker rmi fedora/httpd
# HISTORY |
1b2b783b |
April 2014, Originally compiled by William Henry (whenry at redhat dot com) |
fa29b1f0 |
based on docker.com source material and internal work. |
f8d9ecfb |
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> |
b6d55ebc |
April 2015, updated by Mary Anthony for v2 <mary@docker.com> |