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

.SH NAME

.PP

docker\-rm \- Remove one or more containers

.SH SYNOPSIS

.PP

\fBdocker rm\fP

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

[\fB\-l\fP|\fB\-\-link\fP]

[\fB\-v\fP|\fB\-\-volumes\fP]

CONTAINER [CONTAINER...]

.SH DESCRIPTION

.PP

\fBdocker rm\fP will remove one or more containers from the host node. The

container name or ID can be used. This does not remove images. You cannot

remove a running container unless you use the \fB\-f\fP option. To see all

containers on a host use the \fBdocker ps \-a\fP command.

.SH OPTIONS

.PP

\fB\-\-help\fP

  Print usage statement

.PP

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

   Force the removal of a running container (uses SIGKILL). The default is \fIfalse\fP.

.PP

\fB\-l\fP, \fB\-\-link\fP=\fItrue\fP|\fIfalse\fP

   Remove the specified link and not the underlying container. The default is \fIfalse\fP.

.PP

\fB\-v\fP, \fB\-\-volumes\fP=\fItrue\fP|\fIfalse\fP

   Remove the volumes associated with the container. The default is \fIfalse\fP.

.SH EXAMPLES

.SH Removing a container using its ID

.PP

To remove a container using its ID, find either from a \fBdocker ps \-a\fP

command, or use the ID returned from the \fBdocker run\fP command, or retrieve

it from a file used to store it using the \fBdocker run \-\-cidfile\fP:

.PP

.RS

.nf

docker rm abebf7571666

.fi

.RE

.SH Removing a container using the container name

.PP

The name of the container can be found using the \fBdocker ps \-a\fP

command. The use that name as follows:

.PP

.RS

.nf

docker rm hopeful\_morse

.fi

.RE

.SH Removing a container and all associated volumes

.PP

$ docker rm \-v redis

  redis

.PP

This command will remove the container and any volumes associated with it.

Note that if a volume was specified with a name, it will not be removed.

.PP

$ docker create \-v awesome:/foo \-v /bar \-\-name hello redis

  hello

  $ docker rm \-v hello

.PP

In this example, the volume for \fB\fC/foo\fR will remain in tact, but the volume for

\fB\fC/bar\fR will be removed. The same behavior holds for volumes inherited with

\fB\fC\-\-volumes\-from\fR.

.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]

July 2014, updated by Sven Dowideit 

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

August 2014, updated by Sven Dowideit 

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