1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/docs/man/docker-rm.1.md
Sven Dowideit e01baa6be7 Auto-update documentation from the output of the cli.
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)
2014-12-05 10:43:38 +10:00

1.7 KiB

% 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