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.1/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+ |
Bump pytest-cov 2.8.1
Bump flake8 3.7.9
Bump coverage 4.5.4
Decode APIError explanation to unicode before usage on start and create of a container
Reports when images that cannot be pulled and must be built
Discard label com.docker.compose.filepaths having None as value. Typically, when coming from stdin
Added OSX binary as a directory to solve slow start up time caused by MacOS Catalina binary scan
Passed in HOME env-var in container mode (running with script/run/run.sh)
Reverted behavior of "only pull images that we can't build" and replace by a warning informing the image we can't pull and must be built
Thanks to @dependabot-preview[bot], @ulyssessouza for contributing to this release!
| Binary name | SHA-256 sum |
|---|---|
docker-compose-Darwin-x86_64.tgz | b34e72a5ab3b3b18bad79dcd3537e8b1d63cc7229e85749cb10745d53fbcdcf1 |
docker-compose-Darwin-x86_64 | 2e689d1b5981995dc43838cad3860a3c0a9fe7a453a9a98fbe04b62e54b898b2 |
docker-compose-Linux-x86_64 | 5df53b57bba0ad83af69f0f39c15f0316626302aba876954ea842892c875dd6a |
docker-compose-Windows-x86_64.exe | a65a06545b2bc5c8ebb1f4c2b3531c7d792e2798a3d62ffdfc87f19a37c8d435 |
Fetched March 31, 2026