Skip to content

@ulyssessouza ulyssessouza released this Mar 28, 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 @ulyssessouza for contributing to this release!

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 d949e80dee7269cd703d034bae1861b81e693db88d56fbe7bec9b45f30a8ddb8
docker-compose-Linux-x86_64 bee6460f96339d5d978bb63d17943f773e1a140242dfa6c941d5e020a302c91b
docker-compose-Windows-x86_64.exe bc6d0b49f534e1bd9325c0a8f729d125849ce69cf9e3231cd4f5c842d5e08c29
Assets 9
You can’t perform that action at this time.