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.23.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+ |
Fixed a bug where working with containers created with a previous (< 1.23.0) version of Compose would cause unexpected crashes
Fixed an issue where the behavior of the --project-directory flag would
vary depending on which subcommand was being used.
Thanks to @shin- for contributing to this release!
| Binary name | SHA-256 sum |
|---|---|
docker-compose-Darwin-x86_64 | 34da0d5878ebe264e335097297ee2039ee284b05e6e4191baaa8710fca935fd3 |
docker-compose-Linux-x86_64 | c176543737b8aea762022245f0f4d58781d3cb1b072bc14f3f8e5bb96f90f1a2 |
docker-compose-Windows-x86_64.exe | 55ad51bf61b6e9997eb56a3e8255ac4df6d9ccfcfccc7855b4680f5d752b9255 |
Fetched March 31, 2026