Docker - Install Docker Compose

Install using the repository

1. Set up the repository. Find distro-specific instructions in:

   Ubuntu | CentOS | Debian | Raspberry Pi OS | Fedora | RHEL | SLES.

2. Update the package index, and install the latest version of Docker Compose:

   • For Ubuntu and Debian, run:

     $ sudo apt-get update
     $ sudo apt-get install docker-compose-plugin

3. Verify that Docker Compose is installed correctly by checking the version.

   $ docker compose version
   Docker Compose version vN.N.N

 

Install Compose standalone

Important

From July 2023 Compose V1 stopped receiving updates. It's also no longer available in new releases of Docker Desktop.

Compose V2 is included with all currently supported versions of Docker Desktop. For more information, see Migrate to Compose V2.

Docker's documentation refers to and describes Compose V2 functionality.

On this page you can find instructions on how to install Compose standalone on Linux or Windows Server, from the command line.

On Linux

Compose standalone

Note that Compose standalone uses the -compose syntax instead of the current standard syntax compose.
For example type docker-compose up when using Compose standalone, instead of docker compose up.

1. To download and install Compose standalone, run:

$ curl -SL https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

2. Apply executable permissions to the standalone binary in the target path for the installation.

3. Test and execute compose commands using docker-compose.

   Tip

   If the command docker-compose fails after installation, check your path. You can also create a symbolic link to /usr/bin or any other directory in your path. For example:

   $ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose