If you're a Mac or Windows user, the best way to install Compose and keep it up-to-date is Docker Desktop for Mac and Windows.
Docker Desktop 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.25.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|
|2.2, 3.0, 3.1, 3.2||1.13.0+|
|2.3, 3.3, 3.4, 3.5||17.06.0+|
Added support for connecting to the Docker Engine using the
docker-compose psto include stopped one-off containers
in the command's output.
Add bash completion for
Support for credential_spec
docker build's options in
Fixed a bug where some valid credential helpers weren't properly handled by Compose
when attempting to pull images from private registries.
Fixed an issue where the output of
docker-compose startbefore containers were created
To match the Docker CLI behavior and to avoid confusing issues, Compose will no longer
accept whitespace in variable names sourced from environment files.
Compose will now report a configuration error if a service attempts to declare
duplicate mount points in the volumes section.
Fixed an issue with the containerized version of Compose that prevented users from
writing to stdin during interactive sessions started by
One-off containers started by
runno longer adopt the restart policy of the service,
and are instead set to never restart.
Fixed an issue that caused some container events to not appear in the output of
Missing images will no longer stop the execution of
(a warning will be displayed instead).
virtualenvversion for macOS CI
Fix merging of compose files when network has
CTRL+Cissues by enabling
3.7.2to fix SSH and proxy config issues
Fix release script and some typos on release documentation
|Binary name||SHA-256 sum|