compose/docs/install.md

page_title: Installing Compose page_description: How to intall Docker Compose page_keywords: compose, orchestration, install, installation, docker, documentation

Installing Compose

To install Compose, you'll need to install Docker first. You'll then install Compose with a curl command.

Install Docker

First, you'll need to install Docker version 1.3 or greater.

If you're on OS X, you can use the OS X installer to install both Docker and the OSX helper app, boot2docker. Once boot2docker is running, set the environment variables that'll configure Docker and Compose to talk to it:

$(boot2docker shellinit)

To persist the environment variables across shell sessions, add the above line to your ~/.bashrc file.

For complete instructions, or if you are on another platform, consult Docker's installation instructions.

Install Compose

To install Compose, run the following commands:

curl -L https://github.com/docker/docker-compose/releases/download/1.1.0-rc2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Optionally, you can also install command completion for the bash shell.

Compose is available for OS X and 64-bit Linux. If you're on another platform, Compose can also be installed as a Python package:

$ sudo pip install -U docker-compose

No further steps are required; Compose should now be successfully installed. You can test the installation by running docker-compose --version.