Skip to content

@ulyssessouza ulyssessouza released this Aug 7, 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+



  • Added support for connecting to the Docker Engine using the ssh protocol.

  • Added a --all flag to docker-compose ps to include stopped one-off containers
    in the command's output.

  • Add bash completion for ps --all|-a

  • Support for credential_spec

  • Add --parallel to docker build's options in bash and zsh completion


  • Fixed a bug where some valid credential helpers weren't properly handled by Compose
    when attempting to pull images from private registries.

  • Fixed an issue where the output of docker-compose start before containers were created
    was misleading

  • To match the Docker CLI behavior and to avoid confusing issues, Compose will no longer
    accept whitespace in variable names sourced from environment files.

  • Compose will now report a configuration error if a service attempts to declare
    duplicate mount points in the volumes section.

  • Fixed an issue with the containerized version of Compose that prevented users from
    writing to stdin during interactive sessions started by run or exec.

  • One-off containers started by run no longer adopt the restart policy of the service,
    and are instead set to never restart.

  • Fixed an issue that caused some container events to not appear in the output of
    the docker-compose events command.

  • Missing images will no longer stop the execution of docker-compose down commands
    (a warning will be displayed instead).

  • Force virtualenv version for macOS CI

  • Fix merging of compose files when network has None config

  • Fix CTRL+C issues by enabling bootloader_ignore_signals in pyinstaller

  • Bump docker-py version to 3.7.2 to fix SSH and proxy config issues

  • Fix release script and some typos on release documentation

Thanks to @ijc, @javabrett, @albers, @dave-tucker, @seemethere, @silvin-lubecki, @jcsirot, @Inconnu08, @Goryudyuma, @chris-crone, @rumpl, @KlaasH, @ulyssessouza for contributing to this release!

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 02eebebb7ecf508008d8f583f52e3b9565147e66eb77f9261cbc38449a5ab8e9
docker-compose-Linux-x86_64 a19f02e3ff4b5f0adffd0cec6c10940e916e4358548ae3ed1316e5ffac2b52f4
docker-compose-Windows-x86_64.exe 7f466092df57e4ac9e0ec2f438bac8e9d411c585828368943fc82368e723fdc6
Assets 9
You can’t perform that action at this time.