All Versions
130
Latest Version
3.7
Avg Release Cycle
15 days
Latest Release
-

Changelog History
Page 7

  • v1.24.0 Changes

    March 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
    🐧 docker-compose-Linux-x86_64
    🏁 docker-compose-Windows-x86_64.exe

  • v1.24.0-rc3 Changes

    March 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 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
    🐧 docker-compose-Linux-x86_64
    🏁 docker-compose-Windows-x86_64.exe

  • v1.24.0-rc1 Changes

    January 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 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
    🐧 docker-compose-Linux-x86_64
    🏁 docker-compose-Windows-x86_64.exe

  • v1.23.2 Changes

    November 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 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
    🐧 docker-compose-Linux-x86_64
    🏁 docker-compose-Windows-x86_64.exe

  • v1.23.1 Changes

    November 01, 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 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
    🐧 docker-compose-Linux-x86_64
    🏁 docker-compose-Windows-x86_64.exe

  • v1.23.0 Changes

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

    0️⃣ 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
    🐧 docker-compose-Linux-x86_64
    🏁 docker-compose-Windows-x86_64.exe

  • v1.23.0-rc3 Changes

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

    0️⃣ 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
    🐧 docker-compose-Linux-x86_64
    🏁 docker-compose-Windows-x86_64.exe

  • v1.23.0-rc2 Changes

    October 08, 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 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

    0️⃣ 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
    🐧 docker-compose-Linux-x86_64
    🏁 docker-compose-Windows-x86_64.exe

  • v1.22.0 Changes

    July 17, 2018

    🔋 Features

  • v1.21.2 Changes

    May 03, 2018

    🛠 Bugfixes

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