Skip to content

@shin- shin- released this May 2, 2017 · 1339 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.2 1.13.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1+


Breaking changes

  • docker-compose up now resets a service's scaling to its default value.
    You can use the newly introduced --scale option to specify a custom
    scale value

New features

Compose file version 2.2

  • Introduced version 2.2 of the docker-compose.yml specification. This
    version requires to be used with Docker Engine 1.13.0 or above

  • Added support for init in service definitions.

  • Added support for scale in service definitions. The configuration's value
    can be overridden using the --scale flag in docker-compose up.
    Please note that the scale command is disabled for this file format

Compose file version 2.x

  • Added support for options in the ipam section of network definitions


  • Fixed a bug where paths provided to compose via the -f option were not
    being resolved properly

  • Fixed a bug where the ext_ip::target_port notation in the ports section
    was incorrectly marked as invalid

  • Fixed an issue where the exec command would sometimes not return control
    to the terminal when using the -d flag

  • Fixed a bug where secrets were missing from the output of the config
    command for v3.2 files

  • Fixed an issue where docker-compose would hang if no internet connection
    was available

  • Fixed an issue where paths containing unicode characters passed via the -f
    flag were causing Compose to crash

  • Fixed an issue where the output of docker-compose config would be invalid
    if the Compose file contained external secrets

  • Fixed a bug where using --exit-code-from with up would fail if Compose
    was installed in a Python 3 environment

  • Fixed a bug where recreating containers using a combination of tmpfs and
    volumes would result in an invalid config state

Thanks to @sdurrheimer, @albers, @kinghuang, @fate-grand-order and @brainnwaveDuncan for contributing to this release!

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