compose Files

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

Changes

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

Bugfixes

• 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

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