releases.shpreview
Docker/Docker Compose

Docker Compose

$npx -y @buildinternet/releases show docker-compose
Mon
Wed
Fri
AprMayJunJulAugSepOctNovDecJanFebMarApr
Less
More
Releases5Avg2/moVersionsv5.0.2 → v5.1.3
Jan 20, 2020

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 https://github.com/docker/compose/releases/download/v1.25.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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • Allow compatibility option with COMPOSE_COMPATIBILITY environment variable

  • Bump PyInstaller from 3.5 to 3.6

  • Bump pysocks from 1.6.7 to 1.7.1

  • Bump websocket-client from 0.32.0 to 0.57.0

  • Bump urllib3 from 1.24.2 to 1.25.7

  • Bump jsonschema from 3.0.1 to 3.2.0

  • Bump PyYAML from 4.2b1 to 5.3

  • Bump certifi from 2017.4.17 to 2019.11.28

  • Bump coverage from 4.5.4 to 5.0.3

  • Bump paramiko from 2.6.0 to 2.7.1

  • Bump cached-property from 1.3.0 to 1.5.1

  • Bump minor Linux and MacOSX dependencies

Bugfixes

  • Validate version format on formats 2+

  • Assume infinite terminal width when not running in a terminal

Thanks to @thaJeztah, @GeyseR, @kiniou, @yukihira1992, @benthorner, @chris-crone, @frenzymadness, @dependabot-preview[bot], @ndeloof, @ulyssessouza for contributing to 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 https://github.com/docker/compose/releases/download/1.25.2-rc1/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • Allow compatibility option with COMPOSE_COMPATIBILITY environment variable

  • Bump PyInstaller from 3.5 to 3.6

  • Bump pysocks from 1.6.7 to 1.7.1

  • Bump websocket-client from 0.32.0 to 0.57.0

  • Bump urllib3 from 1.24.2 to 1.25.7

  • Bump jsonschema from 3.0.1 to 3.2.0

  • Bump PyYAML from 4.2b1 to 5.3

  • Bump certifi from 2017.4.17 to 2019.11.28

  • Bump coverage from 4.5.4 to 5.0.3

  • Bump paramiko from 2.6.0 to 2.7.1

  • Bump cached-property from 1.3.0 to 1.5.1

  • Bump minor Linux and MacOSX dependencies

Bugfixes

  • Validate version format on formats 2+

  • Assume infinite terminal width when not running in a terminal

Thanks to @thaJeztah, @GeyseR, @kiniou, @yukihira1992, @benthorner, @chris-crone, @frenzymadness, @dependabot-preview[bot], @ndeloof, @ulyssessouza for contributing to this release!

Jan 7, 2020

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 https://github.com/docker/compose/releases/download/1.25.1/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • Bump pytest-cov 2.8.1

  • Bump flake8 3.7.9

  • Bump coverage 4.5.4

Bugfixes

  • Decode APIError explanation to unicode before usage on start and create of a container

  • Reports when images that cannot be pulled and must be built

  • Discard label com.docker.compose.filepaths having None as value. Typically, when coming from stdin

  • Added OSX binary as a directory to solve slow start up time caused by MacOS Catalina binary scan

  • Passed in HOME env-var in container mode (running with script/run/run.sh)

  • Reverted behavior of "only pull images that we can't build" and replace by a warning informing the image we can't pull and must be built

Thanks to @dependabot-preview[bot], @ulyssessouza for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_64.tgzb34e72a5ab3b3b18bad79dcd3537e8b1d63cc7229e85749cb10745d53fbcdcf1
docker-compose-Darwin-x86_642e689d1b5981995dc43838cad3860a3c0a9fe7a453a9a98fbe04b62e54b898b2
docker-compose-Linux-x86_645df53b57bba0ad83af69f0f39c15f0316626302aba876954ea842892c875dd6a
docker-compose-Windows-x86_64.exea65a06545b2bc5c8ebb1f4c2b3531c7d792e2798a3d62ffdfc87f19a37c8d435
Nov 29, 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 https://github.com/docker/compose/releases/download/1.25.1-rc1/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Bugfixes

  • Discard label com.docker.compose.filepaths having None as value. Typically, when coming from stdin

  • Add OSX binary as a directory to solve slow start up time caused by MacOS Catalina binary scan

  • Pass in HOME env-var in container mode (running with script/run/run.sh)

  • Revert behavior of "only pull images that we can't build" and replace by a warning informing the image we can't pull and must be built

Thanks to @glance-, @chris-crone, @ndeloof, @ulyssessouza for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_64.tgz1b8b4907625a5586598a061b06e845ff8e99adf512e3dd6ef4e799036945488f
docker-compose-Darwin-x86_647d3c402000b331943286eb682c5ce4a063ba7a8a6664ce242c8c443368aaebf1
docker-compose-Linux-x86_64bb9817614deb6206b49da6048855db18b8f8e89598abf895c63f2fa8f21568e6
docker-compose-Windows-x86_64.exe6654fa4cf90041ff13f68ad625d548a6de16d7c0a08b0b33cf93099a66f82455
Nov 18, 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 https://github.com/docker/compose/releases/download/1.25.0/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • Set no-colors to true if CLICOLOR env variable is set to 0

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

  • Add dependencies for ARM build

  • 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 setup.py for modern pypi/setuptools and remove pandoc dependencies

  • Removed Dockerfile.armhf which is no longer needed

Bugfixes

  • Make container service color deterministic, remove red from chosen colors

  • Fix non ascii chars error. Python2 only

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

  • Use Python Posix support to get tty size

  • 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 @glours, @smamessier, @ajlai, @jcsirot, @zelahi, @rumpl, @ulyssessouza for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_64eda3064d769e1e6741b5eab302c9f25a1dd5ccaf87f82cbbbb89fb8ddcede01f
docker-compose-Linux-x86_642bdab0bbf42583b4b77ee015cf908933c78f0572a7cb949a7dd8e200e6250221
docker-compose-Windows-x86_64.exea5dde54d360de1972758bcde20f7eeee5a8d13a9a6b1921198c17616eee51f3e
Oct 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 https://github.com/docker/compose/releases/download/1.25.0-rc4/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • 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 setup.py for modern pypi/setuptools and remove pandoc dependencies

  • Removed Dockerfile.armhf which is no longer needed

Bugfixes

  • 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 nameSHA-256 sum
docker-compose-Darwin-x86_64e670e32e1394d3906481950f7e0d64c49cd5f02e9b87ae94f5087711a99dc393
docker-compose-Linux-x86_64029959a6e0d7ca9966a5abd82b9d7df255343a05a8005c01ca597d71e74c4ac0
docker-compose-Windows-x86_64.exe15a7e62b20afff49505711a474e8710277c5dea2e7005cfdcd5063a6b05bef05

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 https://github.com/docker/compose/releases/download/1.25.0-rc3/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • 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

Bugfixes

  • 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 @chibby0ne, @aiordache, @samueljsb, @danilkister, @silvin-lubecki, @Marian-Gappa, @lukas9393, @okor, @chris-crone, @amezin, @StefanScherer, @jcsirot, @guillaumerose, @rumpl, @zelahi, @orisano, @glours, @ndeloof, @ulyssessouza for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_64b48ca542dc579ab9cf0ad7688521df79a429d02c3183361580ce412873a126c9
docker-compose-Linux-x86_6401849bc76682662f8f5416a858c7a2a150688e44ed5e9e0614a9cacab2f329b7
docker-compose-Windows-x86_64.exee22746289e9e700723b38f6b94cc164cbb04e416213eb751edc853786d84b91f
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 https://github.com/docker/compose/releases/download/1.25.0-rc2/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • 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

Bugfixes

  • 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 nameSHA-256 sum
docker-compose-Darwin-x86_6402eebebb7ecf508008d8f583f52e3b9565147e66eb77f9261cbc38449a5ab8e9
docker-compose-Linux-x86_64a19f02e3ff4b5f0adffd0cec6c10940e916e4358548ae3ed1316e5ffac2b52f4
docker-compose-Windows-x86_64.exe7f466092df57e4ac9e0ec2f438bac8e9d411c585828368943fc82368e723fdc6
Jun 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 https://github.com/docker/compose/releases/download/1.24.1/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Bugfixes

  • Fixed acceptance tests

Thanks to @dave-tucker, @rumpl for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_64c43ae04d666b6ec3480b172a9e1c9e6c591b6b76b4a6e0fa4eb953455e115927
docker-compose-Linux-x86_64cfb3439956216b1248308141f7193776fcf4b9c9b49cbbe2fb07885678e2bb8a
docker-compose-Windows-x86_64.exe60d449ad3dbb2db10a9dd1ac7cbd00ffcb86a286109f94c743a46ba660b036e2
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 https://github.com/docker/compose/releases/download/1.25.0-rc1/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • 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 setup.py for modern pypi/setuptools and remove pandoc dependencies

  • Removed Dockerfile.armhf which is no longer needed

Bugfixes

  • 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 nameSHA-256 sum
docker-compose-Darwin-x86_64ef5d02ce3dbd21509a4dcbe7e80c03012559959d3780be8c47e721f68fb17608
docker-compose-Linux-x86_640822cebd28959f1acdaef0402e630959c1f7ccd66dae9603d6031b1674d7254b
docker-compose-Windows-x86_64.exe1a1acc09a5727ae547ffe448c611e648ce3aaa04b6ca3624ecbe6ab95793f69f
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 https://github.com/docker/compose/releases/download/1.24.0/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • 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

Bugfixes

  • 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 nameSHA-256 sum
docker-compose-Darwin-x86_64d949e80dee7269cd703d034bae1861b81e693db88d56fbe7bec9b45f30a8ddb8
docker-compose-Linux-x86_64bee6460f96339d5d978bb63d17943f773e1a140242dfa6c941d5e020a302c91b
docker-compose-Windows-x86_64.exebc6d0b49f534e1bd9325c0a8f729d125849ce69cf9e3231cd4f5c842d5e08c29
Mar 22, 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 https://github.com/docker/compose/releases/download/1.24.0-rc3/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • 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

Bugfixes

  • 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.1 to fix SSH issues

  • Fix release script and some typos on release documentation

Thanks to @albers, @rumpl, @bfirsh, @mikesir87, @chris-crone, @ulyssessouza for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_64e61ffbb335d8427aa6becf5a61c281d8b07065b408c599787b08cd88fdda564d
docker-compose-Linux-x86_6462758d897f54a7ce34a58ca12abd0c8948bc64b065118f3cd778b36f29df39fe
docker-compose-Windows-x86_64.exe1e4695288b5bf4c15692ba5743be7ebd7eebadf89b6a1a6538bdf0c52c227476
Jan 14, 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 https://github.com/docker/compose/releases/download/1.24.0-rc1/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

  • 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.

Bugfixes

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

Thanks to @albers, @ceh, @gmsantos, @Cyral, @nvllsvm, @alexpusch, @hirochachacha, @and800, @qboot, @smueller18, @ofek, @ulyssessouza, @hartwork, @Dimrok, @collin5, @shin- for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_647e943fd92103e3355610b50353d653a755861d3261feded2c1cf825acf4f1bdf
docker-compose-Linux-x86_64451b7dbb34a4ee3b69abc9c60414ee277416d69069e200274b2f37da0d558d30
docker-compose-Windows-x86_64.exe5296ba4dd323cf53a371092f49394fe33b7a33ce96944b55b6f23d2137eade57
Nov 28, 2018

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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Bugfixes

  • 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 nameSHA-256 sum
docker-compose-Darwin-x86_64c7e900cdfcd1e60dc6828e399473b46e7070acab514472fe91aac4130d9deb58
docker-compose-Linux-x86_644d618e19b91b9a49f36d041446d96a1a0a067c676330a4f25aca6bbd000de7a9
docker-compose-Windows-x86_64.exe0d3fc3acd98a0b906eda5c235267f53ad994cc21d7ab6e3af83fb3762c70350f
Nov 1, 2018

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.1/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Bugfixes

  • Fixed a bug where working with containers created with a previous (< 1.23.0) version of Compose would cause unexpected crashes

  • Fixed an issue where the behavior of the --project-directory flag would vary depending on which subcommand was being used.

Thanks to @shin- for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_6434da0d5878ebe264e335097297ee2039ee284b05e6e4191baaa8710fca935fd3
docker-compose-Linux-x86_64c176543737b8aea762022245f0f4d58781d3cb1b072bc14f3f8e5bb96f90f1a2
docker-compose-Windows-x86_64.exe55ad51bf61b6e9997eb56a3e8255ac4df6d9ccfcfccc7855b4680f5d752b9255
Oct 30, 2018

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.0/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Important note

The default naming scheme for containers created by Compose in this version has changed from <project>_<service>_<index> to <project>_<service>_<index>_<slug>, where <slug> is a randomly-generated hexadecimal string. Please make sure to update scripts relying on the old naming scheme accordingly before upgrading.

Features

  • Logs for containers restarting after a crash will now appear in the output of the up and logs commands.

  • Added --hash option to the docker-compose config command, allowing users to print a hash string for each service's configuration to facilitate rolling updates.

  • Added --parallel flag to the docker-compose build command, allowing Compose to build up to 5 images simultaneously.

  • Output for the pull command now reports status / progress even when pulling multiple images in parallel.

  • For images with multiple names, Compose will now attempt to match the one present in the service configuration in the output of the images command.

Bugfixes

  • Parallel run commands for the same service will no longer fail due to name collisions.

  • Fixed an issue where paths longer than 260 characters on Windows clients would cause docker-compose build to fail.

  • Fixed a bug where attempting to mount /var/run/docker.sock with Docker Desktop for Windows would result in failure.

  • The --project-directory option is now used by Compose to determine where to look for the .env file.

  • docker-compose build no longer fails when attempting to pull an image with credentials provided by the gcloud credential helper.

  • Fixed the --exit-code-from option in docker-compose up to always report the actual exit code even when the watched container isn't the cause of the exit.

  • Fixed an issue that would prevent recreating a service in some cases where a volume would be mapped to the same mountpoint as a volume declared inside the image's Dockerfile.

  • Fixed a bug that caused hash configuration with multiple networks to be inconsistent, causing some services to be unnecessarily restarted.

  • Fixed a bug that would cause failures with variable substitution for services with a name containing one or more dot characters

  • Fixed a pipe handling issue when using the containerized version of Compose.

  • Fixed a bug causing external: false entries in the Compose file to be printed as external: true in the output of docker-compose config

  • Fixed a bug where issuing a docker-compose pull command on services without a defined image key would cause Compose to crash

  • Volumes and binds are now mounted in the order they're declared in the service definition

Miscellaneous

  • The zsh completion script has been updated with new options, and no longer suggests container names where service names are expected.

Thanks to @nickhiggs, @ofek, @chris-crone, @glorpen, @graphaelli, @wfender, @deivid-rodriguez, @jrbenito, @mirake, @tossmilestone, @riverzhang, @maxwellb, @bhuisgen, @nvllsvm, @albers, @silvin-lubecki, @Dimrok for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_64eccd8d406307ca0f7d9c4bd8ebeeba82fc600698da163a8a638f48f06c7b466b
docker-compose-Linux-x86_645b6f948a264a2c018a124b3cae0ce788f14b94a37ab05ca3ba3bb8622f5b7d0b
docker-compose-Windows-x86_64.exe1cb3eb5e3a8a90c8efa4260c7ec46322f1e25b6bec5eaa5cbb876d8c611916f3
Oct 17, 2018

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.0-rc3/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Important note

The default naming scheme for containers created by Compose in this version has changed from <project>_<service>_<index> to <project>_<service>_<index>_<slug>, where <slug> is a randomly-generated hexadecimal string. Please make sure to update scripts relying on the old naming scheme accordingly before upgrading.

Features

  • Logs for containers restarting after a crash will now appear in the output of the up and logs commands.

  • Added --hash option to the docker-compose config command, allowing users to print a hash string for each service's configuration to facilitate rolling updates.

  • Output for the pull command now reports status / progress even when pulling multiple images in parallel.

  • For images with multiple names, Compose will now attempt to match the one present in the service configuration in the output of the images command.

Bugfixes

  • Parallel run commands for the same service will no longer fail due to name collisions.

  • Fixed an issue where paths longer than 260 characters on Windows clients would cause docker-compose build to fail.

  • Fixed a bug where attempting to mount /var/run/docker.sock with Docker Desktop for Windows would result in failure.

  • The --project-directory option is now used by Compose to determine where to look for the .env file.

  • docker-compose build no longer fails when attempting to pull an image with credentials provided by the gcloud credential helper.

  • Fixed the --exit-code-from option in docker-compose up to always report the actual exit code even when the watched container isn't the cause of the exit.

  • Fixed an issue that would prevent recreating a service in some cases where a volume would be mapped to the same mountpoint as a volume declared inside the image's Dockerfile.

  • Fixed a bug that caused hash configuration with multiple networks to be inconsistent, causing some services to be unnecessarily restarted.

  • Fixed a bug that would cause failures with variable substitution for services with a name containing one or more dot characters

  • Fixed a pipe handling issue when using the containerized version of Compose.

  • Fixed a bug causing external: false entries in the Compose file to be printed as external: true in the output of docker-compose config

  • Fixed a bug where issuing a docker-compose pull command on services without a defined image key would cause Compose to crash

  • Volumes and binds are now mounted in the order they're declared in the service definition

Miscellaneous

  • The zsh completion script has been updated with new options, and no longer suggests container names where service names are expected.

Thanks to @nvllsvm, @ofek, @shin- for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_644274268b91d82d002ae6e5b6d82fe52cb357692c72ea0f86b5b81e5da36fcf85
docker-compose-Linux-x86_64118304eaec17c5ccb256181518f5ec1b49a142ba4ffb668eb9071472a5b1fd3a
docker-compose-Windows-x86_64.execb39fc0f744ffe90a9222c49297fbb0a4f51c40a5c745221fade1f33b4eae378
Oct 8, 2018

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.0-rc2/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Important note

The default naming scheme for containers created by Compose in this version has changed from <project>_<service>_<index> to <project>_<service>_<index>_<slug>, where <slug> is a randomly-generated hexadecimal string. Please make sure to update scripts relying on the old naming scheme accordingly before upgrading.

Features

  • Logs for containers restarting after a crash will now appear in the output of the up and logs commands.

  • Added --hash option to the docker-compose config command, allowing users to print a hash string for each service's configuration to facilitate rolling updates.

  • Output for the pull command now reports status / progress even when pulling multiple images in parallel.

  • For images with multiple names, Compose will now attempt to match the one present in the service configuration in the output of the images command.

Bugfixes

  • Parallel run commands for the same service will no longer fail due to name collisions.

  • Fixed an issue where paths longer than 260 characters on Windows clients would cause docker-compose build to fail.

  • Fixed a bug where attempting to mount /var/run/docker.sock with Docker Desktop for Windows would result in failure.

  • The --project-directory option is now used by Compose to determine where to look for the .env file.

  • docker-compose build no longer fails when attempting to pull an image with credentials provided by the gcloud credential helper.

  • Fixed the --exit-code-from option in docker-compose up to always report the actual exit code even when the watched container isn't the cause of the exit.

  • Fixed a bug that caused hash configuration with multiple networks to be inconsistent, causing some services to be unnecessarily restarted.

  • Fixed a pipe handling issue when using the containerized version of Compose.

  • Fixed a bug causing external: false entries in the Compose file to be printed as external: true in the output of docker-compose config

  • Fixed a bug where issuing a docker-compose pull command on services without a defined image key would cause Compose to crash

  • Volumes and binds are now mounted in the order they're declared in the service definition

Miscellaneous

  • The zsh completion script has been updated with new options, and no longer suggests container names where service names are expected.

Thanks to @albers, @silvin-lubecki, @shin-, @Dimrok for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_645891d17d01149caa485dbc60ee37f110ad6ef36730dedcf23a5bbb77525004ef
docker-compose-Linux-x86_64b11d3ff0e9e2a28f4bcdbf6af4e53694672e1219e7d686d54d6af75eeee93980
docker-compose-Windows-x86_64.exe16da4fdc2c167c1dfb5bd0fcce5a9527f694825b63cce5c979102b46586681a0
Sep 26, 2018

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.0-rc1/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Important note

The default naming scheme for containers created by Compose in this version has changed from <project>_<service>_<index> to <project>_<service>_<index>_<slug>, where <slug> is a randomly-generated hexadecimal string. Please make sure to update scripts relying on the old naming scheme accordingly before upgrading.

Features

  • Logs for containers restarting after a crash will now appear in the output of the up and logs commands.

  • Added --hash option to the docker-compose config command, allowing users to print a hash string for each service's configuration to facilitate rolling updates.

  • Output for the pull command now reports status / progress even when pulling multiple images in parallel.

  • For images with multiple names, Compose will now attempt to match the one present in the service configuration in the output of the images command.

Bugfixes

  • Parallel run commands for the same service will no longer fail due to name collisions.

  • Fixed an issue where paths longer than 260 characters on Windows clients would cause docker-compose build to fail.

  • Fixed a bug where attempting to mount /var/run/docker.sock with Docker Desktop for Windows would result in failure.

  • The --project-directory option is now used by Compose to determine where to look for the .env file.

  • docker-compose build no longer fails when attempting to pull an image with credentials provided by the gcloud credential helper.

  • Fixed the --exit-code-from option in docker-compose up to always report the actual exit code even when the watched container isn't the cause of the exit.

  • Fixed a bug that caused hash configuration with multiple networks to be inconsistent, causing some services to be unnecessarily restarted.

  • Fixed a pipe handling issue when using the containerized version of Compose.

  • Fixed a bug causing external: false entries in the Compose file to be printed as external: true in the output of docker-compose config

Miscellaneous

  • The zsh completion script has been updated with new options, and no longer suggests container names where service names are expected.

Thanks to @nickhiggs, @ofek, @chris-crone, @glorpen, @graphaelli, @wfender, @deivid-rodriguez, @jrbenito, @mirake, @tossmilestone, @riverzhang, @maxwellb, @bhuisgen, @shin- for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_641f332c45a39c24c62161f219e8a21bc1bcd11daf7f1c832f2a48c3e57679a938
docker-compose-Linux-x86_64fd16840ca6fdd3a1be2e12bc94d4e768dd819a66b954f41b10d032597746aea6
docker-compose-Windows-x86_64.exe4b2db3b88eccbacdb6150d209dabc83d9ec4ee0c57fdd5ab527a9c7fa1b38484
Jul 17, 2018

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.22.0/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 formatDocker Engine
11.9.0+
2.01.10.0+
2.11.12.0+
2.2, 3.0, 3.1, 3.21.13.0+
2.3, 3.3, 3.4, 3.517.06.0+
2.417.12.0+
3.618.02.0+
3.718.06.0+

Changes

Features

Compose format version 3.7

  • Introduced version 3.7 of the docker-compose.yml specification. This version requires Docker Engine 18.06.0 or above.

  • Added support for rollback_config in the deploy configuration

  • Added support for the init parameter in service configurations

  • Added support for extension fields in service, network, volume, secret, and config configurations

Compose format version 2.4

  • Added support for extension fields in service, network, and volume configurations

Bugfixes

  • Fixed a bug that prevented deployment with some Compose files when DOCKER_DEFAULT_PLATFORM was set

  • Compose will no longer try to create containers or volumes with invalid starting characters

  • Fixed several bugs that prevented Compose commands from working properly with containers created with an older version of Compose

  • Fixed an issue with the output of docker-compose config with the --compatibility-mode flag enabled when the source file contains attachable networks

  • Fixed a bug that prevented the gcloud credential store from working properly when used with the Compose binary on UNIX

  • Fixed a bug that caused connection errors when trying to operate over a non-HTTPS TCP connection on Windows

  • Fixed a bug that caused builds to fail on Windows if the Dockerfile was located in a subdirectory of the build context

  • Fixed an issue that prevented proper parsing of UTF-8 BOM encoded Compose files on Windows

  • Fixed an issue with handling of the double-wildcard (**) pattern in .dockerignore files when using docker-compose build

  • Fixed a bug that caused auth values in legacy .dockercfg files to be ignored

  • docker-compose build will no longer attempt to create image names starting with an invalid character

Thanks to @albers @vdemeester, @mnottale, and @shin- for contributing to this release!

Integrity check

Binary nameSHA-256 sum
docker-compose-Darwin-x86_644965a4ca18a33a9987a25e167f7ecf0957b3fbeef16ff9c69fd2a5f37691992f
docker-compose-Linux-x86_64f679a24b93f291c3bffaff340467494f388c0c251649d640e661d509db9d57e9
docker-compose-Windows-x86_64.exee22746289e9e700723b38f6b94cc164cbb04e416213eb751edc853786d84b91f
Previous7891011Next
Latest
v5.1.3
Source
@docker/compose
Tracking Since
Aug 31, 2017
Last fetched Apr 18, 2026
.json·.md·.atom