1.13.0
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.13.0/docker-compose-`uname -s`-`uname -m` > /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.0 – 3.2 | 1.13.0+ |
2.2 | 1.13.0+ |
2.1 | 1.12.0+ |
2.0 | 1.10.0+ |
1.0 | 1.9.1+ |
Changes
Breaking changes
docker-compose up
now resets a service's scaling to its default value.
You can use the newly introduced--scale
option to specify a custom
scale value
New features
Compose file version 2.2
-
Introduced version 2.2 of the
docker-compose.yml
specification. This
version requires to be used with Docker Engine 1.13.0 or above -
Added support for
init
in service definitions. -
Added support for
scale
in service definitions. The configuration's value
can be overridden using the--scale
flag indocker-compose up
.
Please note that thescale
command is disabled for this file format
Compose file version 2.x
- Added support for
options
in theipam
section of network definitions
Bugfixes
-
Fixed a bug where paths provided to compose via the
-f
option were not
being resolved properly -
Fixed a bug where the
ext_ip::target_port
notation in the ports section
was incorrectly marked as invalid -
Fixed an issue where the
exec
command would sometimes not return control
to the terminal when using the-d
flag -
Fixed a bug where secrets were missing from the output of the
config
command for v3.2 files -
Fixed an issue where
docker-compose
would hang if no internet connection
was available -
Fixed an issue where paths containing unicode characters passed via the
-f
flag were causing Compose to crash -
Fixed an issue where the output of
docker-compose config
would be invalid
if the Compose file contained external secrets -
Fixed a bug where using
--exit-code-from
withup
would fail if Compose
was installed in a Python 3 environment -
Fixed a bug where recreating containers using a combination of
tmpfs
and
volumes
would result in an invalid config state
Thanks to @sdurrheimer, @albers, @kinghuang, @fate-grand-order and @brainnwaveDuncan for contributing to this release!