docker compose rm

Estimated reading time: 3 minutes


Removes stopped service containers

Usage

$ docker compose rm [SERVICE...]

Refer to the options section for an overview of available OPTIONS for this command.

Description

Removes stopped service containers.

By default, anonymous volumes attached to containers are not removed. You can override this with -v. To list all volumes, use docker volume ls.

Any data which is not in a volume is lost.

Running the command with no options also removes one-off containers created by docker compose run:

$ docker compose rm
Going to remove djangoquickstart_web_run_1
Are you sure? [yN] y
Removing djangoquickstart_web_run_1 ... done

Options

Name, shorthand Default Description
--all , -a Deprecated - no effect
--force , -f Don't ask to confirm removal
--stop , -s Stop the containers, if required, before removing
--volumes , -v Remove any anonymous volumes attached to containers

Parent command

Command Description
docker compose Docker Compose
Command Description
docker compose build Build or rebuild services
docker compose convert Converts the compose file to platform’s canonical format
docker compose cp Copy files/folders between a service container and the local filesystem
docker compose create Creates containers for a service.
docker compose down Stop and remove containers, networks
docker compose events Receive real time events from containers.
docker compose exec Execute a command in a running container.
docker compose images List images used by the created containers
docker compose kill Force stop service containers.
docker compose logs View output from containers
docker compose ls List running compose projects
docker compose pause Pause services
docker compose port Print the public port for a port binding.
docker compose ps List containers
docker compose pull Pull service images
docker compose push Push service images
docker compose restart Restart containers
docker compose rm Removes stopped service containers
docker compose run Run a one-off command on a service.
docker compose start Start services
docker compose stop Stop services
docker compose top Display the running processes
docker compose unpause Unpause services
docker compose up Create and start containers
docker compose version Show the Docker Compose version information