
Install on Linux
On this page you can find instructions on how to install the Compose on Linux from the command line.
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.
- Set up the repository. Find distro-specific instructions in:
- Ubuntu | CentOS | Debian | Fedora | RHEL | SLES.
- 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
- 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
This option requires you to manage upgrades manually. We recommend setting up Docker’s repository for an easier maintenance.
- 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
$HOMEdirectory. - To install:
- Docker Compose for all users on your system, replace
~/.docker/cli-pluginswith/usr/local/lib/docker/cli-plugins. - A different version of Compose, substitute
v2.11.2with the version of Compose you want to use.
- 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
- Test the installation.
Information reviewed and updated: August 26, 2026.
Published by: REVOLD BLOG – blog.revold.us
Powered by AIR RISE INC & REVOLD AI
Sponsored: CORPIUS
Author: Roman Kravchina
Related Reading on Revold Blog
- How to Mount and Unmount an ISO Image in Linux
- How to Install Proxmox VE on Windows 8.3
- TrueNas Useful Commands
- How To Install PhotoPrism Using Docker Compose
- More Developing & Programming guides
- How To Install Docker Compose on Ubuntu 22.04
- How to Install Jitsi Meet on Ubuntu/Debian with Automatic Let’s Encrypt SSL
- Hot to install Search Engine with Docker image searx/searx — Linux Server, Home Lab
- How to Install and Configure Radarr on Linux Using Docker
- How to Install Nextcloud with Docker on Your Linux Server
- How to install Cockpit for Linux
- How to Install Python Pip on Ubuntu 22.04
- How to Install NGINX FastCGI Cache Purge Module Without Reinstalling NGINX on Ubuntu (Latest Versions)
- This guide will show you how to install a desktop (GUI) graphical interface on your Ubuntu server.
- How to Install Searx Search Engine on Ubuntu / debianArch LinuxFedora / RHEL
- How to Install NVIDIA Drivers on Ubuntu 22.04 LTS
- How to Install Jellyfin Media Server on Ubuntu 24.04
- How to Install Virtualmin on Ubuntu 22.04 or 24.04


