Skip to content

1.20.0-rc1

Pre-release
Pre-release
Compare
Choose a tag to compare
@shin- shin- released this 27 Feb 23:22
1.20.0-rc1
86428af

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

  • 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
bdb0f8dec9815ba562246d398a8854d7fbd23e233cac88a6f9c58553c56e4cc4 docker-compose-Darwin-x86_64
91632399be7dbb106d8eae7dff91b11df6c117738e9cf25e1ece4920aa469ac4 docker-compose-Linux-x86_64
75da9357a69a64c2e4d22d3c47ac82574f371f2587a0c140ee814eb03747979b docker-compose-Windows-x86_64.exe
Assets 9