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.14.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+|
Compose file version 3.3
- Introduced version 3.3 of the
This version requires to be used with Docker Engine 17.06.0 or above.
configskeys only apply to Swarm services
and will be ignored by Compose
Compose file version 2.2
- Added the following parameters in service definitions:
Compose file version 2.1
- Added support for build labels. This feature is also available in the
2.2 and 3.3 formats.
Differences in labels between the Compose file and remote network
will now print a warning instead of preventing redeployment.
Fixed a bug where service's dependencies were being rescaled to their
default scale when running a
Fixed a bug where
docker-compose rmwith the
--stopflag was not
behaving properly when provided with a list of services to remove
Fixed a bug where
cache_fromin the build section would be ignored when
using more than one Compose file.
Fixed a bug where override files would not be picked up by Compose if they
Fixed a bug on Windows Engine where networks would be incorrectly flagged
Fixed a bug where services declaring ports would cause crashes on some
versions of Python 3
Fixed a bug where the output of
docker-compose configwould sometimes
contain invalid port definitions