docker-compose down

docker-compose down stops and removes containers, networks, volumes, and images created by docker-compose up

https://docs.docker.com/compose/reference/down/

docker-compose down
(no output)

• docker-compose down --volumes

-v, --volumes remove named volumes declared in the `volumes` section of the Compose file and anonymous volumes attached to containers.

• docker-compose down --remove-orphans

• docker-compose down && docker-compose build --pull && docker-compose up -d

Help

docker-compose down --help
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.

Usage: down [options]

Options:
    --rmi type              Remove images. Type must be one of:
                              'all': Remove all images used by any service.
                              'local': Remove only images that don't have a
                              custom tag set by the `image` field.
    -v, --volumes           Remove named volumes declared in the `volumes`
                            section of the Compose file and anonymous volumes
                            attached to containers.
    --remove-orphans        Remove containers for services not defined in the
                            Compose file
    -t, --timeout TIMEOUT   Specify a shutdown timeout in seconds.
                            (default: 10)

Examples

• docker-compose -volumes down SERVICE_NAME
• docker-compose version 1.23.2, build 1110ad01

docker-compose down
Stopping service1   ... done
Stopping service2 ... done
Removing service1   ... done
Removing service2 ... done
Removing network your_network

docker-compose down
ERROR:
       Can't find a suitable configuration file in this directory or any
       parent. Are you in the right directory?

       Supported filenames: docker-compose.yml, docker-compose.yaml

Related commands

• docker-compose: [ start | stop | restart | pull | up | down | ps ]

See also

• docker-compose, docker-compose.yml: [services | volumes | networks | up | down | restart | logs | create | changelog | version | secrets | config | -v | -h | exec], docker-compose pull, Environment:, Docker-compose.yml examples, .env, release notes, expose:, docker-compose --env-file, services.deploy.resources