@shin- shin- released this Jul 17, 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.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 · 6 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 · 10 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 · 92 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

@shin- shin- released this Apr 27, 2018 · 102 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.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+

Changes

Bugfixes

  • In 1.21.0, we introduced a change to how project names are sanitized for
    internal use in resource names. This caused issues when manipulating an
    existing, deployed application whose name had changed as a result.
    This release properly detects resources using "legacy" naming conventions.

  • Fixed an issue where specifying an in-context Dockerfile using an absolute
    path would fail despite being valid.

  • Fixed a bug where IPAM option changes were incorrectly detected, preventing
    redeployments.

  • Validation of v2 files now properly checks the structure of IPAM configs.

  • Improved support for credentials stores on Windows to include binaries using
    extensions other than .exe. The list of valid extensions is determined by
    the contents of the PATHEXT environment variable.

  • Fixed a bug where Compose would generate invalid binds containing duplicate
    elements with some v3.2 files, triggering errors at the Engine level during
    deployment.

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

Integrity check

Binary name SHA-256 sum
docker-compose-Darwin-x86_64 1a82ba8dd9d8c6ec2fd4a49ddc4bf765ce2d15b1b4d4ee2c357ad8a2cdc4c8a0
docker-compose-Linux-x86_64 16402bfb9a52313a352f31437773242a1ccec9e4a30ccd9dc1e4477a970dc6c9
docker-compose-Windows-x86_64.exe 46e06d41047c32572aec6ddb0a569f1811fc0c321795f5565452f5d31925902f

@shin- shin- released this Apr 10, 2018 · 170 commits to master 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.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
3.6 18.02.0+
3.3 – 3.5 17.06.0+
3.0 – 3.2 1.13.0+
2.4 17.12.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1+

Changes

New features

Compose file version 2.4

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

  • Added support for the platform parameter in service definitions.
    If supplied, the parameter is also used when performing build for the
    service.

Compose file version 2.2 and up

  • Added support for the cpu_rt_period and cpu_rt_runtime parameters
    in service definitions (2.x only).

Compose file version 2.1 and up

  • Added support for the cpu_period parameter in service definitions
    (2.x only).

  • Added support for the isolation parameter in service build configurations.
    Additionally, the isolation parameter is used for builds as well if no
    build.isolation parameter is defined. (2.x only)

All formats

  • Added support for the --workdir flag in docker-compose exec.

  • Added support for the --compress flag in docker-compose build.

  • docker-compose pull is now performed in parallel by default. You can
    opt out using the --no-parallel flag. The --parallel flag is now
    deprecated and will be removed in a future version.

  • Dashes and underscores in project names are no longer stripped out.

  • docker-compose build now supports the use of Dockerfile from outside
    the build context.

Bugfixes

  • Compose now checks that the volume's configuration matches the remote
    volume, and errors out if a mismatch is detected.

  • Fixed a bug that caused Compose to raise unexpected errors when attempting
    to create several one-off containers in parallel.

  • Fixed a bug with argument parsing when using docker-machine config to
    generate TLS flags for exec and run commands.

  • Fixed a bug where variable substitution with an empty default value
    (e.g. ${VAR:-}) would print an incorrect warning.

  • Improved resilience when encoding of the Compose file doesn't match the
    system's. Users are encouraged to use UTF-8 when possible.

  • Fixed a bug where external overlay networks in Swarm would be incorrectly
    recognized as inexistent by Compose, interrupting otherwise valid
    operations.

Thanks to @mnottale, @g0t4, @dnephin, @dakotahawkins, @brainlock and @albers for contributing to this release!

Integrity check

SHA-256 sum Binary name
6cadd64afbd1606e1517b91df591a0104c882a2343865aaa9c7ad9dcae81faf5 docker-compose-Darwin-x86_64
af639f5e9ca229442c8738135b5015450d56e2c1ae07c0aaa93b7da9fe09c2b0 docker-compose-Linux-x86_64
f0d52f0323727a9a6a68fa2739bf3c033e64a2d18437d7b31766d7e2e034131e docker-compose-Windows-x86_64.exe
Pre-release

@shin- shin- released this Apr 2, 2018 · 174 commits to master 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.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
3.6 18.02.0+
3.3 – 3.5 17.06.0+
3.0 – 3.2 1.13.0+
2.4 17.12.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1+

Changes

New features

Compose file version 2.4

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

  • Added support for the platform parameter in service definitions.
    If supplied, the parameter is also used when performing build for the
    service.

Compose file version 2.2 and up

  • Added support for the cpu_rt_period and cpu_rt_runtime parameters
    in service definitions (2.x only).

Compose file version 2.1 and up

  • Added support for the cpu_period parameter in service definitions
    (2.x only).

  • Added support for the isolation parameter in service build configurations.
    Additionally, the isolation parameter is used for builds as well if no
    build.isolation parameter is defined. (2.x only)

All formats

  • Added support for the --workdir flag in docker-compose exec.

  • Added support for the --compress flag in docker-compose build.

  • docker-compose pull is now performed in parallel by default. You can
    opt out using the --no-parallel flag. The --parallel flag is now
    deprecated and will be removed in a future version.

  • Dashes and underscores in project names are no longer stripped out.

  • docker-compose build now supports the use of Dockerfile from outside
    the build context.

Bugfixes

  • Compose now checks that the volume's configuration matches the remote
    volume, and errors out if a mismatch is detected.

  • Fixed a bug that caused Compose to raise unexpected errors when attempting
    to create several one-off containers in parallel.

  • Fixed a bug with argument parsing when using docker-machine config to
    generate TLS flags for exec and run commands.

  • Fixed a bug where variable substitution with an empty default value
    (e.g. ${VAR:-}) would print an incorrect warning.

  • Improved resilience when encoding of the Compose file doesn't match the
    system's. Users are encouraged to use UTF-8 when possible.

  • Fixed a bug where external overlay networks in Swarm would be incorrectly
    recognized as inexistent by Compose, interrupting otherwise valid
    operations.

Thanks to @mnottale, @g0t4, @dnephin, @dakotahawkins, @brainlock and @albers for contributing to this release!

Integrity check

SHA-256 sum Binary name
82c690090293a721b6c84dcdc08c13256cca1816fa4a6c2f1676418bae71d3cb docker-compose-Darwin-x86_64
db6990617d550aa7126217bb00f3041da58ef1eeeb5d902a8833fea07b66490a docker-compose-Linux-x86_64
4e3bacebc8922a3ad09156473bb3d82c10faa56264ad3b1c0a4893460b347c4d docker-compose-Windows-x86_64.exe

@shin- shin- released this Mar 21, 2018 · 251 commits to master 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.20.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
3.6 18.02.0+
3.3 – 3.5 17.06.0+
3.0 – 3.2 1.13.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1+

Changes

Bugfixes

  • Fixed an issue where docker-compose build would error out if the
    build context contained directory symlinks

Integrity check

SHA-256 sum Binary name
4a7a03b6184558f1efe962b47dbc489412ce5de4c420a3e116aaae6e03a140d3 docker-compose-Darwin-x86_64
11a6923c2a589b946598fe205c8f645e57f3f4ee153d3b7315b7e1993c1b2ad1 docker-compose-Linux-x86_64
ac40acdfa6283aabc1ca4b57ce8d0241fbe1f71409714ce0f357d1ea7624496d docker-compose-Windows-x86_64.exe

@shin- shin- released this Mar 20, 2018 · 255 commits to master 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.20.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
3.6 18.02.0+
3.3 – 3.5 17.06.0+
3.0 – 3.2 1.13.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1+

Changes

New features

Compose file version 3.6

  • Introduced version 3.6 of the docker-compose.yml specification.
    This version requires to be used with Docker Engine 18.02.0 or above.

  • Added support for the tmpfs.size property in volume mappings

Compose file version 3.2 and up

  • The --build-arg option can now be used without specifying a service
    in docker-compose build

Compose file version 2.3

  • Added support for device_cgroup_rules in service definitions

  • Added support for the tmpfs.size property in long-form volume mappings

  • The --build-arg option can now be used without specifying a service
    in docker-compose build

All formats

  • Added a --log-level option to the top-level docker-compose command.
    Accepted values are debug, info, warning, error, critical.
    Default log level is info

  • docker-compose run now allows users to unset the container's entrypoint

  • Proxy configuration found in the ~/.docker/config.json file now populates
    environment and build args for containers created by Compose

  • Added the --use-aliases flag to docker-compose run, indicating that
    network aliases declared in the service's config should be used for the
    running container

  • Added the --include-deps flag to docker-compose pull

  • docker-compose run now kills and removes the running container upon
    receiving SIGHUP

  • docker-compose ps now shows the containers' health status if available

  • Added the long-form --detach option to the exec, run and up
    commands

Bugfixes

  • Fixed .dockerignore handling, notably with regard to absolute paths
    and last-line precedence rules

  • Fixed an issue where Compose would make costly DNS lookups when connecting
    to the Engine when using Docker For Mac

  • Fixed a bug introduced in 1.19.0 which caused the default certificate path
    to not be honored by Compose

  • Fixed a bug where Compose would incorrectly check whether a symlink's
    destination was accessible when part of a build context

  • Fixed a bug where .dockerignore files containing lines of whitespace
    caused Compose to error out on Windows

  • Fixed a bug where --tls* and --host options wouldn't be properly honored
    for interactive run and exec commands

  • A seccomp:<filepath> entry in the security_opt config now correctly
    sends the contents of the file to the engine

  • ANSI output for up and down operations should no longer affect the wrong
    lines

  • Improved support for non-unicode locales

  • Fixed a crash occurring on Windows when the user's home directory name
    contained non-ASCII characters

  • Fixed a bug occurring during builds caused by files with a negative mtime
    values in the build context

Thanks to @mnottale, @mefyl, @albers, @pantuza, @kcboschert, @jsdalton, @ghsatpute, @geigerzaehler, @garribas, @dihmuzikien, @d2s, @briandealwis and @artagnon for contributing to this release!

Integrity check

SHA-256 sum | Binary name
500f9ab56a76af04d9cd2ed1b953f8b663a9a212b9955d44536743e9200bcbd4 | docker-compose-Darwin-x86_64
3099f4087251c06e8d693877adb571365fcdf0819eeaa6ed37097978d2c50e83 | docker-compose-Linux-x86_64
587b41a75271ed37dd27b482a379844a296f92bde856cfad9068c17864c37393 | docker-compose-Windows-x86_64.exe

Pre-release

@shin- shin- released this Mar 12, 2018 · 261 commits to master 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.20.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
3.6 18.02.0+
3.3 – 3.5 17.06.0+
3.0 – 3.2 1.13.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1+

Changes

New features

Compose file version 3.6

  • Introduced version 3.6 of the docker-compose.yml specification.
    This version requires to be used with Docker Engine 18.02.0 or above.

  • Added support for the tmpfs.size property in volume mappings

Compose file version 3.2 and up

  • The --build-arg option can now be used without specifying a service
    in docker-compose build

Compose file version 2.3

  • Added support for device_cgroup_rules in service definitions

  • Added support for the tmpfs.size property in long-form volume mappings

  • The --build-arg option can now be used without specifying a service
    in docker-compose build

All formats

  • Added a --log-level option to the top-level docker-compose command.
    Accepted values are debug, info, warning, error, critical.
    Default log level is info

  • docker-compose run now allows users to unset the container's entrypoint

  • Proxy configuration found in the ~/.docker/config.json file now populates
    environment and build args for containers created by Compose

  • Added the --use-aliases flag to docker-compose run, indicating that
    network aliases declared in the service's config should be used for the
    running container

  • Added the --include-deps flag to docker-compose pull

  • docker-compose run now kills and removes the running container upon
    receiving SIGHUP

  • docker-compose ps now shows the containers' health status if available

  • Added the long-form --detach option to the exec, run and up
    commands

Bugfixes

  • Fixed .dockerignore handling, notably with regard to absolute paths
    and last-line precedence rules

  • Fixed an issue where Compose would make costly DNS lookups when connecting
    to the Engine when using Docker For Mac

  • Fixed a bug introduced in 1.19.0 which caused the default certificate path
    to not be honored by Compose

  • Fixed a bug where Compose would incorrectly check whether a symlink's
    destination was accessible when part of a build context

  • Fixed a bug where .dockerignore files containing lines of whitespace
    caused Compose to error out on Windows

  • Fixed a bug where --tls* and --host options wouldn't be properly honored
    for interactive run and exec commands

  • A seccomp:<filepath> entry in the security_opt config now correctly
    sends the contents of the file to the engine

  • ANSI output for up and down operations should no longer affect the wrong
    lines

  • Improved support for non-unicode locales

  • Fixed a crash occurring on Windows when the user's home directory name
    contained non-ASCII characters

  • Fixed a bug occurring during builds caused by files with a negative mtime
    values in the build context

Thanks to @mnottale, @mefyl, @albers, @pantuza, @kcboschert, @jsdalton, @ghsatpute, @geigerzaehler, @garribas, @dihmuzikien, @d2s, @briandealwis and @artagnon for contributing to this release!

Integrity check

SHA-256 sum Binary name
069f4078e37e7703353f7f8fe77216f7433654f3f7890cc702058693fb9502e3 docker-compose-Darwin-x86_64
3d59b1ce1ecee52e200bd375c6d0309f42ed59dc7bdac1658d67ff088c04cf7d docker-compose-Linux-x86_64
221561892c2153648466de5f647fefcceeb78188e7bc71a52ec0999f8acc50d9 docker-compose-Windows-x86_64.exe