% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014
docker-rm - Remove one or more containers
docker rm [-f|--force] [-l|--link] [-v|--volumes] CONTAINER [CONTAINER...]
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 -f option. To see all containers on a host use the docker ps -a command.
--help Print usage statement
-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.
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
The name of the container can be found using the docker ps -a command. The use that name as follows:
docker rm hopeful_morse
$ docker rm -v redis redis
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.
$ docker create -v awesome:/foo -v /bar --name hello redis hello $ docker rm -v hello
In this example, the volume for
/foo will remain in tact, but the volume for
/bar will be removed. The same behavior holds for volumes inherited with
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