Install on Linux

Estimated reading time: 3 minutes

On this page you can find instructions on how to install the Compose on Linux from the command line.

Install Compose

To install Compose:

Install using the repository

Note

These instructions assume you already have Docker Engine and Docker CLI installed and now want to install the Compose plugin.
For Compose standalone, see Install Compose Standalone.

If you have already set up the Docker repository, jump to step 2.

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

    Ubuntu | CentOS | Debian | Fedora | RHEL | SLES.

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

    • Ubuntu, Debian:

        $ sudo apt-get update
        $ sudo apt-get install docker-compose-plugin
      
    • RPM-based distros:

        $ sudo yum update
        $ sudo yum 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
    

Where vN.N.N is placeholder text standing in for the latest version.

Update Compose

To update Compose, run the following commands:

  • Ubuntu, Debian:

      $ sudo apt-get update
      $ sudo apt-get install docker-compose-plugin
    
  • RPM-based distros:

      $ sudo yum update
      $ sudo yum install docker-compose-plugin
    

Install the plugin manually

Note

This option requires you to manage upgrades manually. We recommend setting up Docker’s repository for an easier maintenance.

  1. To download and install the Compose CLI plugin, run:

    $ DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
    $ mkdir -p $DOCKER_CONFIG/cli-plugins
    $ curl -SL https://github.com/docker/compose/releases/download/v2.11.2/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose
    

    This command downloads the latest release of Docker Compose (from the Compose releases repository) and installs Compose 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.
    • A different version of Compose, substitute v2.11.2 with the version of Compose you want to use.
  2. Apply executable permissions to the binary:

     $ chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
    

    or, if you chose to install Compose for all users:

     $ sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
    
  3. Test the installation.

     $ docker compose version
     Docker Compose version v2.11.2
    

Where to go next

compose, orchestration, install, installation, docker, documentation