The Wayback Machine - https://web.archive.org/web/20190522020635/https://github.com/docker/compose/releases
Skip to content

/compose

Latest release
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.24.0
Latest release

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

  • 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 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
Pre-release
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.24.0-rc3
Pre-release

@ulyssessouza ulyssessouza released this Mar 22, 2019 · 4 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 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 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

  • 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 name SHA-256 sum
docker-compose-Darwin-x86_64 e61ffbb335d8427aa6becf5a61c281d8b07065b408c599787b08cd88fdda564d
docker-compose-Linux-x86_64 62758d897f54a7ce34a58ca12abd0c8948bc64b065118f3cd778b36f29df39fe
docker-compose-Windows-x86_64.exe 1e4695288b5bf4c15692ba5743be7ebd7eebadf89b6a1a6538bdf0c52c227476
Assets 9
Pre-release
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.24.0-rc1
Pre-release

@rumpl rumpl released this Jan 14, 2019 · 22 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 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 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

  • 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 name SHA-256 sum
docker-compose-Darwin-x86_64 7e943fd92103e3355610b50353d653a755861d3261feded2c1cf825acf4f1bdf
docker-compose-Linux-x86_64 451b7dbb34a4ee3b69abc9c60414ee277416d69069e200274b2f37da0d558d30
docker-compose-Windows-x86_64.exe 5296ba4dd323cf53a371092f49394fe33b7a33ce96944b55b6f23d2137eade57
Assets 9
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.23.2

@shin- shin- released this Nov 28, 2018 · 160 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 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
Assets 9
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.23.1

@shin- shin- released this Nov 1, 2018 · 169 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 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
Assets 9
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.23.0

@shin- shin- released this Oct 30, 2018 · 173 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 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
Assets 9
Pre-release
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.23.0-rc3
Pre-release

@shin- shin- released this Oct 17, 2018 · 179 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 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
Assets 9
Pre-release
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.23.0-rc2
Pre-release

@silvin-lubecki silvin-lubecki released this Oct 8, 2018 · 194 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 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
Assets 9
Pre-release
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.23.0-rc1
Pre-release

@shin- shin- released this Sep 26, 2018 · 206 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 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
Assets 9
Verified
This commit was created on GitHub.com and signed with a verified signature using GitHub’s key.
GPG key ID: 4AEE18F83AFDEB23 Learn about signing commits
1.22.0

@shin- shin- released this Jul 17, 2018 · 281 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 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
Assets 9
You can’t perform that action at this time.