mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
e01baa6be7
I've re-jigged the run man page so that each option's text begins with the cli's help text for that flag, and then ay subsequent lines in the man page are carried forward. Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au> Docker-DCO-1.1-Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au> (github: SvenDowideit)
53 lines
1.7 KiB
Markdown
53 lines
1.7 KiB
Markdown
% DOCKER(1) Docker User Manuals
|
|
% Docker Community
|
|
% JUNE 2014
|
|
# NAME
|
|
docker-rm - Remove one or more containers
|
|
|
|
# SYNOPSIS
|
|
**docker rm**
|
|
[**-f**|**--force**[=*false*]]
|
|
[**-l**|**--link**[=*false*]]
|
|
[**-v**|**--volumes**[=*false*]]
|
|
CONTAINER [CONTAINER...]
|
|
|
|
# DESCRIPTION
|
|
|
|
**docker rm** 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\fR option. To see all
|
|
containers on a host use the **docker ps -a** command.
|
|
|
|
# OPTIONS
|
|
**-f**, **--force**=*true*|*false*
|
|
Force the removal of a running container (uses SIGKILL). The default is *false*.
|
|
|
|
**-l**, **--link**=*true*|*false*
|
|
Remove the specified link and not the underlying container. The default is *false*.
|
|
|
|
**-v**, **--volumes**=*true*|*false*
|
|
Remove the volumes associated with the container. The default is *false*.
|
|
|
|
# EXAMPLES
|
|
|
|
##Removing a container using its ID##
|
|
|
|
To remove a container using its ID, find either from a **docker ps -a**
|
|
command, or use the ID returned from the **docker run** command, or retrieve
|
|
it from a file used to store it using the **docker run --cidfile**:
|
|
|
|
docker rm abebf7571666
|
|
|
|
##Removing a container using the container name##
|
|
|
|
The name of the container can be found using the **docker ps -a**
|
|
command. The use that name as follows:
|
|
|
|
docker rm hopeful_morse
|
|
|
|
# HISTORY
|
|
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 <SvenDowideit@home.org.au>
|
|
July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|
|
August 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|