Install Docker Compose On Mac

Last time, after restarting Docker for Mac, the issue went away, so I didn't get a chance to test if the daemon was responsive. I hadn't seen the issue again until today. I am able to launch new containers using the regular docker command, but not through docker-compose. All the circumstances I described previously are still true - the machine. So you can installl the docker engine and just work with docker but when you want to use docker compose you need to install it seperatly (where the installation of the engine is a prerequisition (you've alread done this)). So try now the link I gave in the answer (you can use curl or pip to install docker-compose) –.

Estimated reading time: 6 minutes

Compose V2 and the new docker compose command


The new Compose V2, which supports the compose command as part of the Docker CLI, is now available.

Compose V2 integrates compose functions into the Docker platform, continuing to support most of the previous docker-compose features and flags. You can test the Compose V2 by simply replacing the dash (-) with a space, and by running docker compose, instead of docker-compose.

Starting with Docker Desktop 3.4.0, you can run Compose V2 commands without modifying your invocations, by enabling the drop-in replacement of the previous docker-compose with the new command. See the section Installing Compose V2 for detailed instructions how to enable the drop-in replacement.

Context of Docker Compose evolution

Introduction of the Compose specification makes a clean distinction between the Compose YAML file model and the docker-compose implementation. Making this change has enabled a number of enhancements, including adding the compose command directly into the Docker CLI, being able to “up” a Compose application on cloud platforms by simply switching the Docker context, and launching of Amazon ECS and Microsoft ACI. As the Compose specification evolves, new features land faster in the Docker CLI.

While docker-compose is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. This allows us to include community proposals, experimental implementations by the Docker CLI and/or Engine, and deliver features faster to users. Compose V2 also supports some of the newer additions to the Compose specification, such as profiles and GPU devices.

Additionally, Compose V2 also supports Apple silicon.

For more information about the flags that are supported in the new compose command, see the docker-compose compatibility list.

Transitioning to GA for Compose V2

We are currently working towards providing a standard way to install Compose V2 on Linux. When this is available, Compose V2 will be marked as Generally Available (GA).

Compose V2 GA means:

  • New features and bug fixes will only be considered in the Compose V2 code base.
  • Docker Compose V2 will be the default setting in Docker Desktop for Mac and Windows. You can still opt out through the Docker Desktop UI and the CLI. This means, when you run docker-compose, you will actually be runningdocker compose.
  • Compose V2 will be included with the latest version of the Docker CLI. You can use Compose Switch to redirect docker-compose to docker compose.
  • Compose V2 branch will become the default branch.
  • Docker Compose V1 will be maintained to address any security issues.


We would like to make the Compose V2 transition to be as smooth as possible for all users. We currently don’t have a concrete timeline to deprecate Compose V1. We will review the feedback from the community on the GA and the adoption on Linux, and come up with a plan to deprecate Compose V1. We are not planning to remove the aliasing of docker-compose to docker compose. We would like to make it easier for users to switch to V2 without breaking any existing scripts. We will follow up with a blog post with more information on the exact timeline on V1 deprecation and the end of support policies for security issues.

Your feedback is important to us. Reach out to us and let us know your feedback on our Public Roadmap.

Installing Compose V2

This section contains instructions on how to install Compose V2.

Install on Mac and Windows

Docker Desktop for Mac and for Windows version 3.2.1 and above includes the new Compose command along with the Docker CLI. Therefore, Windows and Mac users do not need to install Compose V2 separately.

We will progressively turn Docker Compose V2 on automatically for Docker Desktop users, so that users can seamlessly move to Docker Compose V2 without the need to change any of their scripts. If you run into any problems with Compose V2, you can simply switch back to Compose v1, either in Docker Desktop, or in the CLI.

For Docker Desktop installation instructions, see:

To disable Docker Compose V2 using Docker Desktop:

  1. From the Docker menu, click Preferences (Settings on Windows) > General.
  2. Clear the Use Docker Compose V2 check box.

To disable Docker Compose V2 using the CLI, run:

Install on Linux

You can install Compose V2 by downloading the appropriate binary for your systemfrom the project release page and copying it into $HOME/.docker/cli-plugins as docker-compose.

  1. Run the following command to download the current stable release of Docker Compose:

    This command installs Compose V2 for the active user under $HOME directory. To install Docker Compose for all users on your system, replace ~/.docker/cli-plugins with /usr/local/lib/docker/cli-plugins.

  2. Apply executable permissions to the binary:

  3. Test your installation

Compose Switch

Compose Switch is a replacement to the Compose V1 docker-compose (python) executable. Compose switch translates the command line into Compose V2 docker compose and then runs the latter.

To install Compose Switch automatically, run:

To install Compose Switch manually:

  1. Download the compose-switch binary for your architecture

  2. Run the following command to make it an executable:

  3. Rename the docker-compose binary if you’ve already installed it as /usr/local/bin/docker-compose

  4. Define an alternatives group for the docker-compose command:

  5. Verify your installation:

Uninstall Docker Compose

If you installed Docker Compose using curl, run the following command to uninstall:

compose, V2

Estimated reading time: 6 minutes

Supported platforms

Install Docker Compose On Mac

Docker Engine is available on a variety of Linux platforms,macOS and Windows 10through Docker Desktop, and as a static binary installation. Findyour preferred operating system below.


Platformx86_64 / amd64arm64 (Apple Silicon)
Docker Desktop for Mac (macOS)
Docker Desktop for Windows


Docker provides .deb and .rpm packages from the following Linux distributionsand architectures:

Platformx86_64 / amd64arm64 / aarch64arm (32-bit)s390x

Other Linux distributions


While the instructions below may work, Docker does not test or verifyinstallation on derivatives.

  • Users of Debian derivatives such as “BunsenLabs Linux”, “Kali Linux” or “LMDE” (Debian-based Mint) should follow the installation instructions forDebian, substituting the version of their distro for thecorresponding Debian release. Refer to the documentation of your distro to findwhich Debian release corresponds with your derivative version.
  • Likewise, users of Ubuntu derivatives such as “Kubuntu”, “Lubuntu” or “Xubuntu”should follow the installation instructions for Ubuntu,substituting the version of their distro for the corresponding Ubuntu release.Refer to the documentation of your distro to find which Ubuntu releasecorresponds with your derivative version.
  • Some Linux distributions are providing a package of Docker Engine through theirpackage repositories. These packages are built and maintained by the Linuxdistribution’s package maintainers and may have differences in configurationor built from modified source code. Docker is not involved in releasing thesepackages and bugs or issues involving these packages should be reported inyour Linux distribution’s issue tracker.

Docker provides binaries for manual installation of Docker Engine.These binaries are statically linked and can be used on any Linux distribution.

Release channels

Docker Engine has three types of update channels, stable, test,and nightly:

  • The Stable channel gives you latest releases for general availability.
  • The Test channel gives pre-releases that are ready for testing beforegeneral availability (GA).
  • The Nightly channel gives you latest builds of work in progress for thenext major release.


Year-month releases are made from a release branch diverged from the masterbranch. The branch is created with format <year>.<month>, for example20.10. The year-month name indicates the earliest possible calendarmonth to expect the release to be generally available. All further patchreleases are performed from that branch. For example, once v20.10.0 isreleased, all subsequent patch releases are built from the 20.10 branch.


In preparation for a new year-month release, a branch is created fromthe master branch with format when the milestones desired byDocker for the release have achieved feature-complete. Pre-releasessuch as betas and release candidates are conducted from their respective releasebranches. Patch releases and the corresponding pre-releases are performedfrom within the corresponding release branch.

Install Docker Compose On Mac Download


Nightly builds give you the latest builds of work in progress for the next majorrelease. They are created once per day from the master branch with the versionformat:

where the time is the commit time in UTC and the final suffix is the prefixof the commit hash, for example 0.0.0-20180720214833-f61e0f7.


These builds allow for testing from the latest code on the master branch. Noqualifications or guarantees are made for the nightly builds.


Docker Engine releases of a year-month branch are supported with patches asneeded for one month after the next year-month general availability release.

This means bug reports and backports to release branches are assesseduntil the end-of-life date.

After the year-month branch has reached end-of-life, the branch may bedeleted from the repository.


Backports to the Docker products are prioritized by the Docker company. ADocker employee or repository maintainer will endeavour to ensure sensiblebugfixes make it into active releases.

If there are important fixes that ought to be considered for backport toactive release branches, be sure to highlight this in the PR descriptionor by adding a comment to the PR.

Upgrade path

Patch releases are always backward compatible with its year-month version.


Install Docker Compose On Mac

Docker is licensed under the Apache License, Version 2.0. SeeLICENSE for the fulllicense text.

Reporting security issues

The Docker maintainers take security seriously. If you discover a securityissue, please bring it to their attention right away!

Please DO NOT file a public issue; instead send your report privatelyto [email protected]

Security reports are greatly appreciated, and Docker will publicly thank youfor it.

Get started

After setting up Docker, you can learn the basics withGetting started with Docker.

docker, installation, install, Docker Engine, Docker Engine, docker editions, stable, edge