Skip to content

@ulyssessouza ulyssessouza released this Nov 29, 2019

If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker Desktop for Mac and Windows.

Docker Desktop 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` -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+



  • Discard label com.docker.compose.filepaths having None as value. Typically, when coming from stdin

  • Add OSX binary as a directory to solve slow start up time caused by MacOS Catalina binary scan

  • Pass in HOME env-var in container mode (running with script/run/

  • Revert behavior of "only pull images that we can't build" and replace by a warning informing the image we can't pull and must be built

Thanks to @glance-, @chris-crone, @ndeloof, @ulyssessouza for contributing to this release!

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64.tgz 1b8b4907625a5586598a061b06e845ff8e99adf512e3dd6ef4e799036945488f
docker-compose-Darwin-x86_64 7d3c402000b331943286eb682c5ce4a063ba7a8a6664ce242c8c443368aaebf1
docker-compose-Linux-x86_64 bb9817614deb6206b49da6048855db18b8f8e89598abf895c63f2fa8f21568e6
docker-compose-Windows-x86_64.exe 6654fa4cf90041ff13f68ad625d548a6de16d7c0a08b0b33cf93099a66f82455
Assets 11
You can’t perform that action at this time.