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-rc1/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+ |
Discard label com.docker.compose.filepaths having None as value. Typically, when coming from stdin
Add OSX binary as a directory to solve slow start up time caused by MacOS Catalina binary scan
Pass in HOME env-var in container mode (running with script/run/run.sh)
Revert 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 @glance-, @chris-crone, @ndeloof, @ulyssessouza for contributing to this release!
| Binary name | SHA-256 sum |
|---|---|
docker-compose-Darwin-x86_64.tgz | 1b8b4907625a5586598a061b06e845ff8e99adf512e3dd6ef4e799036945488f |
docker-compose-Darwin-x86_64 | 7d3c402000b331943286eb682c5ce4a063ba7a8a6664ce242c8c443368aaebf1 |
docker-compose-Linux-x86_64 | bb9817614deb6206b49da6048855db18b8f8e89598abf895c63f2fa8f21568e6 |
docker-compose-Windows-x86_64.exe | 6654fa4cf90041ff13f68ad625d548a6de16d7c0a08b0b33cf93099a66f82455 |
Fetched March 31, 2026