Docker Compose runs applications defined in a Compose YAML file. Current installations normally use the Docker CLI plugin and the docker compose command.

Linux installation

These steps assume Docker Engine and its CLI are already installed from Docker’s supported repository for your distribution. Do not mix repositories without checking compatibility.

On Debian or Ubuntu:

sudo apt update
sudo apt install docker-compose-plugin

On supported RPM-based systems with Docker’s repository configured, use the appropriate package manager, for example:

sudo dnf install docker-compose-plugin

Check the installation:

docker compose version

If the package is unavailable, check Docker’s repository setup instructions for the actual distribution rather than downloading a fixed old binary.

Windows and macOS

Docker Desktop includes Compose. Install the supported Desktop release for the platform, start it, then run docker compose version in a terminal.

Check an application definition

In the directory containing the intended Compose file:

docker compose config

Review the result before starting containers. docker compose up starts the defined application and may create containers, networks and volumes.

The older docker-compose standalone command and Python pip package are legacy installation routes. Use the maintained plugin unless a documented compatibility requirement calls for something else.