compose/docs/reference/compose_down.md

1.7 KiB
Raw Blame History

docker compose down

Stop and remove containers, networks

Options

Name Type Default Description
--remove-orphans Remove containers for services not defined in the Compose file.
--rmi string Remove images used by services. "local" remove only images that don't have a custom tag ("local"|"all")
-t, --timeout int 10 Specify a shutdown timeout in seconds
-v, --volumes Remove named volumes declared in the volumes section of the Compose file and anonymous volumes attached to containers.

Description

Stops containers and removes containers, networks, volumes, and images created by up.

By default, the only things removed are:

  • Containers for services defined in the Compose file
  • Networks defined in the networks section of the Compose file
  • The default network, if one is used

Networks and volumes defined as external are never removed.

Anonymous volumes are not removed by default. However, as they dont have a stable name, they will not be automatically mounted by a subsequent up. For data that needs to persist between updates, use explicit paths as bind mounts or named volumes.