Skip to content

@rumpl rumpl released this Oct 28, 2019 · 15 commits to release since this release

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+



  • Add BuildKit support, use DOCKER_BUILDKIT=1 and COMPOSE_DOCKER_CLI_BUILD=1

  • Bump paramiko to 2.6.0

  • Add working dir, config files and env file in service labels

  • Add tag docker-compose:latest

  • Add docker-compose:<version>-alpine image/tag

  • Add docker-compose:<version>-debian image/tag

  • Bumped docker-py 4.1.0

  • Supports requests up to 2.22.0 version

  • Drops empty tag on build:cache_from

  • Dockerfile now generates libmusl binaries for alpine

  • Only pull images that can't be built

  • Attribute scale can now accept 0 as a value

  • Added --quiet build flag

  • Added --no-interpolate to docker-compose config

  • Bump OpenSSL for macOS build (1.1.0j to 1.1.1c)

  • Added --no-rm to build command

  • Added support for credential_spec

  • Resolve digests without pulling image

  • Upgrade pyyaml to 4.2b1

  • Lowered severity to warning if down tries to remove nonexisting image

  • Use improved API fields for project events when possible

  • Update for modern pypi/setuptools and remove pandoc dependencies

  • Removed Dockerfile.armhf which is no longer needed


  • Fix same file 'extends' optimization

  • Use python POSIX support to get tty size

  • Format image size as decimal to be align with Docker CLI

  • Fixed stdin_open

  • Fixed --remove-orphans when used with up --no-start

  • Fixed docker-compose ps --all

  • Fixed depends_on dependency recreation behavior

  • Fixed bash completion for build --memory

  • Fixed misleading warning concerning env vars when performing an exec command

  • Fixed failure check in parallel_execute_watch

  • Fixed race condition after pulling image

  • Fixed error on duplicate mount points.

  • Fixed merge on networks section

  • Always connect Compose container to stdin

  • Fixed the presentation of failed services on 'docker-compose start' when containers are not available

Thanks to @jcsirot, @rumpl, @orisano, @ulyssessouza for contributing to this release!

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 e670e32e1394d3906481950f7e0d64c49cd5f02e9b87ae94f5087711a99dc393
docker-compose-Linux-x86_64 029959a6e0d7ca9966a5abd82b9d7df255343a05a8005c01ca597d71e74c4ac0
docker-compose-Windows-x86_64.exe 15a7e62b20afff49505711a474e8710277c5dea2e7005cfdcd5063a6b05bef05
Assets 9
You can’t perform that action at this time.