---
name: "docker-compose-down"
section: "1"
platform: "linux"
package: "docker-compose"
version: "2.26.1-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/docker-compose-down"
---

# docker-compose-down(1)

Stop and remove containers, networks

## 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)](/docker-compose/1.md)**