.TH "DOCKER" "1" " Docker User Manuals" "Docker Community" "JUNE 2014"  ""


.SH NAME
.PP
docker\-rmi \- Remove one or more images


.SH SYNOPSIS
.PP
\fBdocker rmi\fP
[\fB\-f\fP|\fB\-\-force\fP]
[\fB\-\-help\fP]
[\fB\-\-no\-prune\fP]
IMAGE [IMAGE...]


.SH DESCRIPTION
.PP
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
\fB\-f\fP option. To see all images on a host use the \fBdocker images\fP command.


.SH OPTIONS
.PP
\fB\-f\fP, \fB\-\-force\fP=\fItrue\fP|\fIfalse\fP
   Force removal of the image. The default is \fIfalse\fP.

.PP
\fB\-\-help\fP
  Print usage statement

.PP
\fB\-\-no\-prune\fP=\fItrue\fP|\fIfalse\fP
   Do not delete untagged parents. The default is \fIfalse\fP.


.SH EXAMPLES
.SH Removing an image
.PP
Here is an example of removing an image:

.PP
.RS

.nf
docker rmi fedora/httpd

.fi
.RE


.SH HISTORY
.PP
April 2014, Originally compiled by William Henry (whenry at redhat dot com)
based on docker.com source material and internal work.
June 2014, updated by Sven Dowideit 
\[la][email protected]\[ra]
April 2015, updated by Mary Anthony for v2 
\[la][email protected]\[ra]