compose/docs/reference/down.md
Aanand Prasad 174afeb974 Merge pull request #3303 from aanand/clarify-rm-and-down
Clarify behaviour of rm and down
(cherry picked from commit 3d3f331404)

Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au>
2016-05-17 05:37:27 +00:00

1.2 KiB

down

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

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.