Docker-DCO-1.1-Signed-off-by: William Henry <whenry@redhat.com> (github: ipbabble) Changes to be committed: modified: contrib/man/md/docker-build.md modified: contrib/man/md/docker-commit.md
1.6 KiB
DOCKER "1" "APRIL 2014" "0.1" "Docker"
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:
When set to true, force the removal of the container. The default is false.
-l
, --link
=true|false:
When set to true, remove the specified link and not the underlying container. The default is false.
-v
, --volumes
=true|false:
When set to true, remove the volumes associated to 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 \fBdocker ps -a\fR 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 dockier.io source material and internal work.