github.com/guilhermebr/docker@v1.4.2-0.20150428121140-67da055cebca/docs/man/docker-rm.1.md (about)

     1  % DOCKER(1) Docker User Manuals
     2  % Docker Community
     3  % JUNE 2014
     4  # NAME
     5  docker-rm - Remove one or more containers
     6  
     7  # SYNOPSIS
     8  **docker rm**
     9  [**-f**|**--force**[=*false*]]
    10  [**-l**|**--link**[=*false*]]
    11  [**-v**|**--volumes**[=*false*]]
    12  CONTAINER [CONTAINER...]
    13  
    14  # DESCRIPTION
    15  
    16  **docker rm** will remove one or more containers from the host node. The
    17  container name or ID can be used. This does not remove images. You cannot
    18  remove a running container unless you use the \fB-f\fR option. To see all
    19  containers on a host use the **docker ps -a** command.
    20  
    21  # OPTIONS
    22  **--help**
    23    Print usage statement
    24  
    25  **-f**, **--force**=*true*|*false*
    26     Force the removal of a running container (uses SIGKILL). The default is *false*.
    27  
    28  **-l**, **--link**=*true*|*false*
    29     Remove the specified link and not the underlying container. The default is *false*.
    30  
    31  **-v**, **--volumes**=*true*|*false*
    32     Remove the volumes associated with the container. The default is *false*.
    33  
    34  # EXAMPLES
    35  
    36  ##Removing a container using its ID##
    37  
    38  To remove a container using its ID, find either from a **docker ps -a**
    39  command, or use the ID returned from the **docker run** command, or retrieve
    40  it from a file used to store it using the **docker run --cidfile**:
    41  
    42      docker rm abebf7571666
    43  
    44  ##Removing a container using the container name##
    45  
    46  The name of the container can be found using the **docker ps -a**
    47  command. The use that name as follows:
    48  
    49      docker rm hopeful_morse
    50  
    51  # HISTORY
    52  April 2014, Originally compiled by William Henry (whenry at redhat dot com)
    53  based on docker.com source material and internal work.
    54  June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
    55  July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
    56  August 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>