@shin- shin- released this Nov 28, 2018

Assets 9

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 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+

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 name SHA-256 sum
docker-compose-Darwin-x86_64 c7e900cdfcd1e60dc6828e399473b46e7070acab514472fe91aac4130d9deb58
docker-compose-Linux-x86_64 4d618e19b91b9a49f36d041446d96a1a0a067c676330a4f25aca6bbd000de7a9
docker-compose-Windows-x86_64.exe 0d3fc3acd98a0b906eda5c235267f53ad994cc21d7ab6e3af83fb3762c70350f

@shin- shin- released this Nov 1, 2018 · 9 commits to release since this release

Assets 9

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 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+

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 name SHA-256 sum
docker-compose-Darwin-x86_64 34da0d5878ebe264e335097297ee2039ee284b05e6e4191baaa8710fca935fd3
docker-compose-Linux-x86_64 c176543737b8aea762022245f0f4d58781d3cb1b072bc14f3f8e5bb96f90f1a2
docker-compose-Windows-x86_64.exe 55ad51bf61b6e9997eb56a3e8255ac4df6d9ccfcfccc7855b4680f5d752b9255

@shin- shin- released this Oct 30, 2018 · 13 commits to release since this release

Assets 9

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 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+

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 name SHA-256 sum
docker-compose-Darwin-x86_64 eccd8d406307ca0f7d9c4bd8ebeeba82fc600698da163a8a638f48f06c7b466b
docker-compose-Linux-x86_64 5b6f948a264a2c018a124b3cae0ce788f14b94a37ab05ca3ba3bb8622f5b7d0b
docker-compose-Windows-x86_64.exe 1cb3eb5e3a8a90c8efa4260c7ec46322f1e25b6bec5eaa5cbb876d8c611916f3
Pre-release
Pre-release

@shin- shin- released this Oct 17, 2018 · 19 commits to release since this release

Assets 9

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 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+

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 name SHA-256 sum
docker-compose-Darwin-x86_64 4274268b91d82d002ae6e5b6d82fe52cb357692c72ea0f86b5b81e5da36fcf85
docker-compose-Linux-x86_64 118304eaec17c5ccb256181518f5ec1b49a142ba4ffb668eb9071472a5b1fd3a
docker-compose-Windows-x86_64.exe cb39fc0f744ffe90a9222c49297fbb0a4f51c40a5c745221fade1f33b4eae378
Pre-release
Pre-release

@silvin-lubecki silvin-lubecki released this Oct 8, 2018 · 34 commits to release since this release

Assets 9

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 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+

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 name SHA-256 sum
docker-compose-Darwin-x86_64 5891d17d01149caa485dbc60ee37f110ad6ef36730dedcf23a5bbb77525004ef
docker-compose-Linux-x86_64 b11d3ff0e9e2a28f4bcdbf6af4e53694672e1219e7d686d54d6af75eeee93980
docker-compose-Windows-x86_64.exe 16da4fdc2c167c1dfb5bd0fcce5a9527f694825b63cce5c979102b46586681a0
Pre-release
Pre-release

@shin- shin- released this Sep 26, 2018 · 46 commits to release since this release

Assets 9

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 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+

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 name SHA-256 sum
docker-compose-Darwin-x86_64 1f332c45a39c24c62161f219e8a21bc1bcd11daf7f1c832f2a48c3e57679a938
docker-compose-Linux-x86_64 fd16840ca6fdd3a1be2e12bc94d4e768dd819a66b954f41b10d032597746aea6
docker-compose-Windows-x86_64.exe 4b2db3b88eccbacdb6150d209dabc83d9ec4ee0c57fdd5ab527a9c7fa1b38484

@shin- shin- released this Jul 17, 2018 · 121 commits to release since this release

Assets 9

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 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+

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 name SHA-256 sum
docker-compose-Darwin-x86_64 4965a4ca18a33a9987a25e167f7ecf0957b3fbeef16ff9c69fd2a5f37691992f
docker-compose-Linux-x86_64 f679a24b93f291c3bffaff340467494f388c0c251649d640e661d509db9d57e9
docker-compose-Windows-x86_64.exe e22746289e9e700723b38f6b94cc164cbb04e416213eb751edc853786d84b91f
Pre-release
Pre-release

@mnottale mnottale released this Jul 5, 2018 · 127 commits to release since this release

Assets 9

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-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 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+

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 @mnottale, @shin- for contributing to this release!

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 6e36be6668714fdef1f65c5165de08314f6c1429285cb46b42242a4dab9a0844
docker-compose-Linux-x86_64 42fc1ca4af68c7b9484c7dbc331d06874318dedcf1db1335aa99b27cf7130bfb
docker-compose-Windows-x86_64.exe a84788e3cbc469f313693e529739d63fdf4a110183fb35d9b5b0343d06b6f785
Pre-release
Pre-release

@shin- shin- released this Jun 21, 2018 · 131 commits to release since this release

Assets 9

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-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 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+

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

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

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 c1daeb11b5198bdac81f3b366f5664314d397e706cee65a8909455a3f849a27b
docker-compose-Linux-x86_64 5f1222d48c5fe9001723fc42ed48d7b3a0bbd903a02145ac6a731ff42a32122b
docker-compose-Windows-x86_64.exe 28720d448f7f99c87797dca9388d1a83d3116f6fb9cbd247e69ec45f3a50f6f6

@shin- shin- released this May 2, 2018 · 213 commits to release since this release

Assets 9

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.21.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 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+

Changes

Bugfixes

  • Fixed a bug where the ip_range attirbute in IPAM configs was prevented
    from passing validation

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 cbbb44bcd14af1c57104099b802898b2bbc359ae06b543bfb9bb6d95302026e2
docker-compose-Linux-x86_64 8a11713e11ed73abcb3feb88cd8b5674b3320ba33b22b2ba37915b4ecffdf042
docker-compose-Windows-x86_64.exe 6f515b821fcbb3e07fdab8ce6da74b9e77ab743ae141d4670280fd26f95af7ef