@shin- shin- released this Nov 28, 2018

Assets 9

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.23.2/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+



  • Reverted a 1.23.0 change that appended random strings to container names
    created by docker-compose up, causing addressability issues.
    Note: Containers created by docker-compose run will continue to use
    randomly generated names to avoid collisions during parallel runs.

  • Fixed an issue where some dockerfile paths would fail unexpectedly when
    attempting to build on Windows.

  • Fixed a bug where build context URLs would fail to build on Windows.

  • Fixed a bug that caused run and exec commands to fail for some otherwise
    accepted values of the --host parameter.

  • Fixed an issue where overrides for the storage_opt and isolation keys in
    service definitions weren't properly applied.

  • Fixed a bug where some invalid Compose files would raise an uncaught
    exception during validation.

Thanks to @shin- for contributing to this release!

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 c7e900cdfcd1e60dc6828e399473b46e7070acab514472fe91aac4130d9deb58
docker-compose-Linux-x86_64 4d618e19b91b9a49f36d041446d96a1a0a067c676330a4f25aca6bbd000de7a9
docker-compose-Windows-x86_64.exe 0d3fc3acd98a0b906eda5c235267f53ad994cc21d7ab6e3af83fb3762c70350f