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 | 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+ |
Added support for connecting to the Docker Engine using the ssh protocol.
Added a --all flag to docker-compose ps to include stopped one-off containers
in the command's output.
Add bash completion for ps --all|-a
Support for credential_spec
Add --parallel to docker build's options in bash and zsh completion
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 start before containers were created
was misleading
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 run or exec.
One-off containers started by run no 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
the docker-compose events command.
Missing images will no longer stop the execution of docker-compose down commands
(a warning will be displayed instead).
Force virtualenv version for macOS CI
Fix merging of compose files when network has None config
Fix CTRL+C issues by enabling bootloader_ignore_signals in pyinstaller
Bump docker-py version to 3.7.2 to fix SSH and proxy config issues
Fix release script and some typos on release documentation
Thanks to @ijc, @javabrett, @albers, @dave-tucker, @seemethere, @silvin-lubecki, @jcsirot, @Inconnu08, @Goryudyuma, @chris-crone, @rumpl, @KlaasH, @ulyssessouza for contributing to this release!
| Binary name | SHA-256 sum |
|---|---|
docker-compose-Darwin-x86_64 | 02eebebb7ecf508008d8f583f52e3b9565147e66eb77f9261cbc38449a5ab8e9 |
docker-compose-Linux-x86_64 | a19f02e3ff4b5f0adffd0cec6c10940e916e4358548ae3ed1316e5ffac2b52f4 |
docker-compose-Windows-x86_64.exe | 7f466092df57e4ac9e0ec2f438bac8e9d411c585828368943fc82368e723fdc6 |
Fetched March 31, 2026