1.22.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.22.0-rc1/docker-compose-`uname -s`-`uname -m` -o /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
1	1.9.0+
2.0	1.10.0+
2.1	1.12.0+
2.2, 3.0, 3.1, 3.2	1.13.0+
2.3, 3.3, 3.4, 3.5	17.06.0+
2.4	17.12.0+
3.6	18.02.0+
3.7	18.06.0+

Changes

Features

Compose format version 3.7

• Introduced version 3.7 of the docker-compose.yml specification. This version requires Docker Engine 18.06.0 or above.

• Added support for rollback_config in the deploy configuration

• Added support for the init parameter in service configurations

• Added support for extension fields in service, network, volume, secret, and config configurations

Compose format version 2.4

• Added support for extension fields in service, network, and volume configurations

Bugfixes

• Fixed a bug that prevented deployment with some Compose files when DOCKER_DEFAULT_PLATFORM was set

• Compose will no longer try to create containers or volumes with invalid starting characters

• Fixed several bugs that prevented Compose commands from working properly with containers created with an older version of Compose

• Fixed an issue with the output of docker-compose config with the --compatibility-mode flag enabled when the source file contains attachable networks

• Fixed a bug that prevented the gcloud credential store from working properly when used with the Compose binary on UNIX

• Fixed a bug that caused connection errors when trying to operate over a non-HTTPS TCP connection on Windows

• Fixed a bug that caused builds to fail on Windows if the Dockerfile was located in a subdirectory of the build context

• Fixed an issue that prevented proper parsing of UTF-8 BOM encoded Compose files on Windows

Thanks to @albers, @vdemeester, @shin- for contributing to this release!

Integrity check

Binary name	SHA-256 sum
docker-compose-Darwin-x86_64	c1daeb11b5198bdac81f3b366f5664314d397e706cee65a8909455a3f849a27b
docker-compose-Linux-x86_64	5f1222d48c5fe9001723fc42ed48d7b3a0bbd903a02145ac6a731ff42a32122b
docker-compose-Windows-x86_64.exe	28720d448f7f99c87797dca9388d1a83d3116f6fb9cbd247e69ec45f3a50f6f6