Docker Compose lets you run complex ap­plic­a­tions using a single command. This means that con­tain­ers can be deployed faster and more ef­fi­ciently. Our tutorial guides you through the Docker Compose Windows in­stall­a­tion step by step.

What are the re­quire­ments of Docker Compose on Windows?

Docker Compose is an integral part of Docker Desktop for Windows. To use the stan­dalone version of Docker Compose, the following re­quire­ments must be met:

  • Docker Engine: Compose is an extension of Docker Engine. So you need to have the Docker Server and Client binaries installed.
  • Operating System: Windows, ad­min­is­trat­or rights
Tip

Our guide shows you how to install Docker Compose on Ubuntu and Docker Compose on macOS.

How to install Docker Compose on Windows step by step

To install and use Docker Compose, Docker Daemon and Docker Client should be running on your Windows server. Before getting started it’s best to ensure that the Docker service is running error-free.

Step 1: Start Power­Shell

First, launch Power­Shell using your ad­min­is­trat­or rights. Confirm ‘Yes’ to allow the app to make changes to your device.

Image: User Account Control
Click ‘Yes’ to begin in­stall­a­tion.

Step 2: Set up TLS security protocol

GitHub requires TLS1.2 as the default security protocol. Run the following command in Windows Power­Shell:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
power­shell

Step 3: Download and install Docker Compose

Download the latest version of Compose (v2.17.2) from GitHub:

Start-BitsTransfer -Source "https://github.com/docker/compose/releases/download/v2.17.2/docker-compose-Windows-x86_64.exe" -Destination $Env:ProgramFiles\Docker\docker-compose.exe
power­shell

To install a different version, simply replace v2.17.2 in the target address with the desired version number.

Step 3: Test Docker Compose

Check if the in­stall­a­tion was suc­cess­ful by dis­play­ing the current version of Compose:

docker compose version
power­shell

You should see the following output:

Image: Docker Compose Version
When you see the version number of Compose, the in­stall­a­tion was suc­cess­ful.
Tip

To get started with Docker, check out our Docker Tutorial or find out more about Docker Commands and Docker Or­ches­tra­tion using Swarm and Compose.

Go to Main Menu