Docker Compose relies on Docker Engine for any meaningful work, so make sure you have Docker Engine installed either locally or remote, depending on your setup.
On desktop systems like Docker for Mac and Windows, Docker Compose is included as part of those desktop installs.
On Linux systems, first install the Docker for your OS as described on the Get Docker page, then come back here for instructions on installing Compose on Linux systems.
To run Compose as a non-root user, see Manage Docker as a non-root user.
Install Compose
Follow the instructions below to install Compose on Mac, Windows, Windows Server 2016, or Linux systems, or find out about alternatives like using the pip Python package manager or installing Compose as a container.
Alternative Install Options
Install Compose on Windows systems
Docker for Windows and Docker Toolbox already include Compose along with other Docker apps, so most Windows users do not need to install Compose separately. Docker install instructions for these are here:
Get Docker for Windows
Get Docker Toolbox (for older systems)
If you are running the Docker daemon and client directly on Microsoft Windows Server 2016 (with Docker EE for Windows Server 2016, you do need to install Docker Compose. To do so, follow these steps:
Start an “elevated” PowerShell (run it as administrator). Search for PowerShell, right-click, and choose Run as administrator. When asked if you want to allow this app to make changes to your device, click Yes.
In Powershell, since Github now requires TLS1.2, run the following:
Use the latest Compose release number in the download command.
As already mentioned, the above command is an example, and it may become out-of-date once in a while. Always follow the command pattern shown above it. If you cut-and-paste an example, check which release it specifies and, if needed, replace $dockerComposeVersion with the release number that you want. Compose releases are also available for direct download on the Compose repository release page on GitHub.
Prerequisites
Docker Compose relies on Docker Engine for any meaningful work, so make sure you have Docker Engine installed either locally or remote, depending on your setup.
Install Compose
Follow the instructions below to install Compose on Mac, Windows, Windows Server 2016, or Linux systems, or find out about alternatives like using the pip Python package manager or installing Compose as a container.
Alternative Install Options
Install Compose on Windows systems
Docker for Windows and Docker Toolbox already include Compose along with other Docker apps, so most Windows users do not need to install Compose separately. Docker install instructions for these are here:
If you are running the Docker daemon and client directly on Microsoft Windows Server 2016 (with Docker EE for Windows Server 2016, you do need to install Docker Compose. To do so, follow these steps:
In Powershell, since Github now requires TLS1.2, run the following:
Then run the following command to download Docker Compose, replacing
$dockerComposeVersionwith the specific version of Compose you want to use:For example, to download Compose version 1.22.0, the command is: