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

     2 

     3 

     4 .SH NAME

     5 .PP

     6 docker\-rmi \- Remove one or more images

     7 

     8 

     9 .SH SYNOPSIS

    10 .PP

    11 \fBdocker rmi\fP

    12 [\fB\-f\fP|\fB\-\-force\fP]

    13 [\fB\-\-help\fP]

    14 [\fB\-\-no\-prune\fP]

    15 IMAGE [IMAGE...]

    16 

    17 

    18 .SH DESCRIPTION

    19 .PP

    20 Removes one or more images from the host node. This does not remove images from

    21 a registry. You cannot remove an image of a running container unless you use the

    22 \fB\-f\fP option. To see all images on a host use the \fBdocker images\fP command.

    23 

    24 

    25 .SH OPTIONS

    26 .PP

    27 \fB\-f\fP, \fB\-\-force\fP=\fItrue\fP|\fIfalse\fP

    28    Force removal of the image. The default is \fIfalse\fP.

    29 

    30 .PP

    31 \fB\-\-help\fP

    32   Print usage statement

    33 

    34 .PP

    35 \fB\-\-no\-prune\fP=\fItrue\fP|\fIfalse\fP

    36    Do not delete untagged parents. The default is \fIfalse\fP.

    37 

    38 

    39 .SH EXAMPLES

    40 .SH Removing an image

    41 .PP

    42 Here is an example of removing an image:

    43 

    44 .PP

    45 .RS

    46 

    47 .nf

    48 docker rmi fedora/httpd

    49 

    50 .fi

    51 .RE

    52 

    53 

    54 .SH HISTORY

    55 .PP

    56 April 2014, Originally compiled by William Henry (whenry at redhat dot com)

    57 based on docker.com source material and internal work.

    58 June 2014, updated by Sven Dowideit 

    59 \[la][email protected]\[ra]

    60 April 2015, updated by Mary Anthony for v2 

    61 \[la][email protected]\[ra]