@shin- shin- released this Jan 17, 2017 · 1306 commits to master since this release

Assets 6

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker for Mac and Windows.

Docker for Mac and Windows will automatically install the latest version of Docker Engine for you.

Alternatively, you can use the usual commands to install or upgrade Compose:

curl -L https://github.com/docker/compose/releases/download/1.10.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

See the install docs for more install options and instructions.

Compose file format compatibility matrix

Compose file format Docker Engine
3.0 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1+

Latest changes

New Features

Compose file version 3.0

  • Introduced version 3.0 of the docker-compose.yml specification. This
    version requires to be used with Docker Engine 1.13 or above and is
    specifically designed to work with the docker stack commands.

Compose file version 2.1 and up

  • Healthcheck configuration can now be done in the service definition using
    the healthcheck parameter
  • Containers dependencies can now be set up to wait on positive healthchecks
    when declared using depends_on. See the documentation for the updated
    Note: This feature will not be ported to version 3 Compose files.
  • Added support for the sysctls parameter in service definitions
  • Added support for the userns_mode parameter in service definitions
  • Compose now adds identifying labels to networks and volumes it creates

Compose file version 2.0 and up

  • Added support for the stop_grace_period option in service definitions.


  • Colored output now works properly on Windows.
  • Fixed a bug where docker-compose run would fail to set up link aliases
    in interactive mode on Windows.
  • Networks created by Compose are now always made attachable
    (Compose files v2.1 and up).
  • Fixed a bug where falsy values of COMPOSE_CONVERT_WINDOWS_PATHS
    (0, false, empty value) were being interpreted as true.
  • Fixed a bug where forward slashes in some .dockerignore patterns weren't
    being parsed correctly on Windows

Thanks to @aanand, @dnephin, @mikedougherty, @graingert, @tntC4stl3, @strayobject, @NiR-, @lawliet89, @jtakkala, @ijc25 for contributing to this release!