⚡ NEW: Compose/install/linux - Full Gallery 2025

This page contains instructions on how to install the Docker Compose plugin on Linux from the command line.

To install the Docker Compose plugin on Linux, you can either:

Note

These instructions assume you already have Docker Engine and Docker CLI installed and now want to install the Docker Compose plugin.

Install using the repository

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

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

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

    • For Ubuntu and Debian, run:

    • For RPM-based distributions, run:

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

Update Docker Compose

To update the Docker Compose plugin, run the following commands:

  • For Ubuntu and Debian, run:

  • For RPM-based distributions, run:

Install the plugin manually

Warning

Manual installations don’t auto-update. For ease of maintenance, use the Docker repository method.

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

    This command downloads and installs the latest release of Docker 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 v5.0.1 with the version of Compose you want to use.
    • For a different architecture, substitute x86_64 with the architecture you want.
  2. Apply executable permissions to the binary:

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

  3. Test the installation.

What's next?