Back to Compose

docker compose down

docs/reference/compose_down.md

5.1.32.4 KB
Original Source

docker compose down

<!---MARKER_GEN_START-->

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 don’t have a stable name, they are not automatically mounted by a subsequent up. For data that needs to persist between updates, use explicit paths as bind mounts or named volumes.

Options

NameTypeDefaultDescription
--dry-runboolExecute command in dry run mode
--remove-orphansboolRemove containers for services not defined in the Compose file
--rmistringRemove images used by services. "local" remove only images that don't have a custom tag ("local"|"all")
-t, --timeoutint0Specify a shutdown timeout in seconds
-v, --volumesboolRemove named volumes declared in the "volumes" section of the Compose file and anonymous volumes attached to containers
<!---MARKER_GEN_END-->

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 don’t have a stable name, they are not automatically mounted by a subsequent up. For data that needs to persist between updates, use explicit paths as bind mounts or named volumes.