docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
docs/content/manuals/compose/install/_index.md

2.8 KiB
Raw Permalink Blame History

description keywords title linkTitle weight toc_max aliases
Learn how to install Docker Compose. Compose is available natively on Docker Desktop, as a Docker Engine plugin, and as a standalone tool. install docker compose, docker compose install, install docker compose ubuntu, installing docker compose, docker compose download, docker compose not found, docker compose windows, how to install docker compose Overview of installing Docker Compose Install 20 3
/compose/compose-desktop/
/compose/install/other/
/compose/install/compose-desktop/

This page contains summary information about the available options for installing Docker Compose.

Installation scenarios

Scenario one: Install Docker Desktop

The easiest and recommended way to get Docker Compose is to install Docker Desktop. Docker Desktop includes Docker Compose along with Docker Engine and Docker CLI which are Compose prerequisites.

Docker Desktop is available on:

If you have already installed Docker Desktop, you can check which version of Compose you have by selecting About Docker Desktop from the Docker menu {{< inline-image src="../../desktop/images/whale-x.svg" alt="whale menu" >}}.

[!NOTE]

After Docker Compose V1 was removed in Docker Desktop version 4.23.0 as it had reached end-of-life, the docker-compose command now points directly to the Docker Compose V2 binary, running in standalone mode. If you rely on Docker Desktop auto-update, the symlink might be broken and command unavailable, as the update doesn't ask for administrator password.

This only affects Mac users. To fix this, either recreate the symlink:

$ sudo rm /usr/local/bin/docker-compose
$ sudo ln -s /Applications/Docker.app/Contents/Resources/cli-plugins/docker-compose /usr/local/bin/docker-compose

Or enable Automatically check configuration which will detect and fix it for you.

Scenario two: Install the Compose plugin

If you already have Docker Engine and Docker CLI installed, you can install the Compose plugin from the command line, by either:

[!IMPORTANT]

This is only available on Linux

Scenario three: Install the Compose standalone

You can install the Compose standalone on Linux or on Windows Server.

[!WARNING]

This install scenario is not recommended and is only supported for backward compatibility purposes.