Skip to content

@shin- shin- released this Feb 6, 2017 · 1603 commits to master since this release

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`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.


  • 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!

Assets 6
You can’t perform that action at this time.