1.11.0-rc1

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.11.0-rc1/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 ; 3.1	1.13.0+
2.1	1.12.0+
2.0	1.10.0+
1.0	1.9.1+

New Features

Compose file version 3.1

• Introduced version 3.1 of the docker-compose.yml specification. This
  version requires Docker Engine 1.13.0 or above. It introduces support
  for secrets. See the documentation for more information

Compose file version 2.0 and up

• Introduced the docker-compose top command that displays processes running
  for the different services managed by Compose.

Bugfixes

• Fixed a bug where extending a service defining a healthcheck dictionary
  would cause docker-compose to error out.
• Fixed an issue where the pid entry in a service definition was being
  ignored when using multiple Compose files.

Thanks to @dnephin, @mattjbray, @xulike666, @urda, @tntC4stl3, @pts-kevinqiu, @muicoder, @graingert, @ankon for contributing to this release!