Skip to content

1.17.0-rc1

Pre-release
Pre-release
Compare
Choose a tag to compare
@shin- shin- released this 18 Oct 00:09
1.17.0-rc1
a0f95af

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.17.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.3 – 3.4 17.06.0+
3.0 – 3.2 1.13.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1+

Changes

New features

Compose file version 3.4

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

  • Added support for cache_from, network and target options in build
    configurations

  • Added support for the order parameter in the update_config section

  • Added support for setting a custom name in volume definitions using
    the name parameter

Compose file version 2.3

  • Added support for shm_size option in build configuration

Compose file version 2.x

  • Added support for extension fields (x-*). Also available for v3.4 files

All formats

  • Added new --no-start to the up command, allowing users to create all
    resources (networks, volumes, containers) without starting services.
    The create command is deprecated in favor of this new option

Bugfixes

  • Fixed a bug where extra_hosts values would be overridden by extension
    files instead of merging together

  • Fixed a bug where the validation for v3.2 files would prevent using the
    consistency field in service volume definitions

  • Fixed a bug that would cause a crash when configuration fields expecting
    unique items would contain duplicates

  • Fixed a bug where mount overrides with a different mode would create a
    duplicate entry instead of overriding the original entry

  • Fixed a bug where build labels declared as a list wouldn't be properly
    parsed

  • Fixed a bug where the output of docker-compose config would be invalid
    for some versions if the file contained custom-named external volumes

  • Improved error handling when issuing a build command on Windows using an
    unsupported file version

  • Fixed an issue where networks with identical names would sometimes be
    created when running up commands concurrently.

Thanks to @AlexeyRokhin, @garribas, @FrenchBen, @vdemeester, @NikitaVlaznev, @jbarciauskas, @hoogenm, @edsrzf, @andrewhsu and @AndreaGiardini for contributing to this release!

Integrity check

SHA sum Binary name
89e1db7a926d4b56ac9e2ae0133a6e279424e87e docker-compose-Darwin-x86_64
27f3648e33ee5c8f68c1d05c9e51a5b6669f94bd docker-compose-Linux-x86_64
4651ab956f1ca6ca4d575af6fd72a011dad82d16 docker-compose-Windows-x86_64.exe
Assets 6
Loading