Docker Compose - 1.23.0-rc2

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 |