1.8.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.
Note that Compose 1.8.0 requires Docker Engine 1.10.0 or later for version 2 of the Compose File format, and Docker Engine 1.9.1 or later for version 1. 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.8.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.
Here's what's new:
Breaking Changes
- As announced in 1.7.0,
docker-compose rm
now removes containers
created bydocker-compose run
by default. - Setting
entrypoint
on a service now empties out any default
command that was set on the image (i.e. anyCMD
instruction in the
Dockerfile used to build it). This makes it consistent with
the--entrypoint
flag todocker run
.
New Features
- Added
docker-compose bundle
, a command that builds a bundle file
to be consumed by the new Docker Stack commands in Docker 1.12. - Added
docker-compose push
, a command that pushes service images
to a registry. - Compose now supports specifying a custom TLS version for
interaction with the Docker Engine using theCOMPOSE_TLS_VERSION
environment variable.
Bug Fixes
- Fixed a bug where Compose would erroneously try to read
.env
at the project's root when it is a directory. docker-compose run -e VAR
now passesVAR
through from the shell
to the container, as withdocker run -e VAR
.- Improved config merging when multiple compose files are involved
for several service sub-keys. - Fixed a bug where volume mappings containing Windows drives would
sometimes be parsed incorrectly. - Fixed a bug in Windows environment where volume mappings of the
host's root directory would be parsed incorrectly. - Fixed a bug where
docker-compose config
would ouput an invalid
Compose file if external networks were specified. - Fixed an issue where unset buildargs would be assigned a string
containing'None'
instead of the expected empty value. - Fixed a bug where yes/no prompts on Windows would not show before
receiving input. - Fixed a bug where trying to
docker-compose exec
on Windows
without the-d
option would exit with a stacktrace. This will
still fail for the time being, but should do so gracefully. - Fixed a bug where errors during
docker-compose up
would show
an unrelated stacktrace at the end of the process. docker-compose create
anddocker-compose start
show more
descriptive error messages when something goes wrong.
Thanks @aanand, @dnephin, @bfirsh, @aeriksson, @SvenDowideit, @londoncalling, @ijc25, @johnharris85, @albers, @leonhartX, @Andrey9kin, @jgiannuzzi, @yorkedork, @Werehuman, @twitherspoon, @TomasTomecek, @staticshock, @stakodiak, @spectralsun, @sanmai-NL, @metal3d, @Knetic, @jamesottaway, @denismakogon, @davidjb, @dannyprout, @CRogers, @chrisclark, @aronahl, @anton44eg, @andrerom, @allencloud, @adamchainz, @activatedgeek