Docker Engine 29 reference · Docker Compose
docker compose down Command (Docker CLI)
Stop and remove a Compose project's containers and networks; -v also deletes its named volumes and their data.
Docker Engine 29
Syntax
docker compose down [OPTIONS]
Parameters
| Parameter | Description |
|---|---|
-v |
Remove named volumes declared in the file (deletes data). |
--rmi all|local |
Remove images used by services. |
--remove-orphans |
Remove containers for services no longer in the file. |
Examples
printf 'services:\n db:\n image: redis:8-alpine\n volumes: [data:/data]\nvolumes:\n data:\n' > compose.yaml
docker compose -p rc-ref-down up -d > /dev/null 2>&1
docker compose -p rc-ref-down down > /dev/null 2>&1
echo "volume kept after down: $(docker volume ls -q --filter name=rc-ref-down_data | wc -l)"
docker compose -p rc-ref-down down -v > /dev/null 2>&1
echo "after down -v: $(docker volume ls -q --filter name=rc-ref-down_data | wc -l)"
Output
volume kept after down: 1 after down -v: 0
Run this on your computer — see “Get Started” for setup.
printf 'services:\n web:\n image: nginx:1.29-alpine\n' > compose.yaml
docker compose -p rc-ref-down2 up -d > /dev/null 2>&1
docker compose -p rc-ref-down2 down 2>&1 | grep -oE 'Network [a-z0-9_-]+ +Removed|Container [a-z0-9_-]+ +Removed' | tr -s ' ' | sort
Output
Container rc-ref-down2-web-1 Removed Network rc-ref-down2_default Removed
Run this on your computer — see “Get Started” for setup.
Related
docker compose up· Create and start every service of a Compose project; -d runs in the background and --wait returns once services are healthy.- Docker Compose Basics · tutorial