docker-container-rm - Remove one or more containers
Contents
Description
dockercontainerrm 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 dockercontainerls-a command.
Examples
Name
docker-container-rm - Remove one or more containers
Options
-f, --force[=false] Force the removal of a running container (uses SIGKILL)
-h, --help[=false] help for rm
-l, --link[=false] Remove the specified link
-v, --volumes[=false] Remove anonymous volumes associated with the container
Removing A Container And All Associated Volumes
$ docker container 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 container 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 --volumes-from.
Removing A Container Using Its Id
To remove a container using its ID, find either from a dockerps-a command, or use the ID returned from
the dockerrun command, or retrieve it from a file used to store it using the dockerrun--cidfile:
docker container rm abebf7571666
Removing A Container Using The Container Name
The name of the container can be found using the dockerps-a command. The use that name as follows:
docker container rm hopeful_morse
See Also
docker-container(1) Docker Community Feb 2025 DOCKER(1)
Synopsis
dockercontainerrm[OPTIONS]CONTAINER[CONTAINER...]
