Scroll to navigation

DOCKER-COMPOSE-DOWN(1) DOCKER-COMPOSE-DOWN(1)

NAME

docker-compose-down - Stop and remove containers, networks

SYNOPSIS

docker compose down [OPTIONS] [SERVICES]

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.

OPTIONS

-h, --help[=false] help for down

--remove-orphans[=false] Remove containers for services not defined in the Compose file

--rmi="" Remove images used by services. "local" remove only images that don't have a custom tag ("local"|"all")

-t, --timeout=0 Specify a shutdown timeout in seconds

-v, --volumes[=false] Remove named volumes declared in the "volumes" section of the Compose file and anonymous volumes attached to containers

OPTIONS INHERITED FROM PARENT COMMANDS

--dry-run[=false] Execute command in dry run mode

SEE ALSO

docker-compose(1)

Feb 2025