Skip to content

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



  • Add tag docker-compose:latest

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

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

  • Bumped docker-py 4.0.1

  • 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.1a)

  • 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


  • 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 @shin-, @tuttieee, @slowr, @akshitgrover, @bfirsh, @joeweoj, @joakimr-axis, @Inconnu08, @orisano, @GeyseR, @albers, @collin5, @kudos, @mikesir87, @CatEars, @rumpl, @ijc, @chris-crone, @ulyssessouza for contributing to this release!

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 ef5d02ce3dbd21509a4dcbe7e80c03012559959d3780be8c47e721f68fb17608
docker-compose-Linux-x86_64 0822cebd28959f1acdaef0402e630959c1f7ccd66dae9603d6031b1674d7254b
docker-compose-Windows-x86_64.exe 1a1acc09a5727ae547ffe448c611e648ce3aaa04b6ca3624ecbe6ab95793f69f
Assets 9
You can’t perform that action at this time.