<commit_before>---
description: How to install Docker Compose
keywords:
- compose, orchestration, install, installation, docker, documentation
menu:
  main:
    parent: workw_compose
    weight: -90
title: Install Compose
---

# Install Docker Compose

You can run Compose on OS X, Windows and 64-bit Linux. To install it, you'll need to install Docker first.

To install Compose, do the following:

1. Install Docker Engine:

     * <a href="/engine/installation/mac/" target="_blank">Mac OS X installation</a>

     * <a href="/engine/installation/windows/" target="_blank">Windows installation</a>

     * <a href="/engine/installation/ubuntulinux/" target="_blank">Ubuntu installation</a>

     * <a href="/engine/installation/" target="_blank">other system installations</a>

2. The Docker Toolbox installation includes both Engine and Compose, so Mac and Windows users are done installing. Others should continue to the next step.

3. Go to the <a href="https://github.com/docker/compose/releases" target="_blank">Compose repository release page on GitHub</a>.

4. Follow the instructions from the release page and run the `curl` command,
which the release page specifies, in your terminal.

     > Note: If you get a "Permission denied" error, your `/usr/local/bin` directory
     probably isn't writable and you'll need to install Compose as the superuser. Run
     `sudo -i`, then the two commands below, then `exit`.

     The following is an example command illustrating the format:

        curl -L https://github.com/docker/compose/releases/download/1.8.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

     If you have problems installing with `curl`, see
     [Alternative Install Options](install.md#alternative-install-options).

5. Apply executable permissions to the binary:

        $ chmod +x /usr/local/bin/docker-compose

6.  Optionally, install [command completion](completion.md) for the
`bash` and `zsh` shell.

7. Test the installation.

        $ docker-compose --version
        docker-compose version: 1.8.0


## Alternative install options

### Install using pip

Compose can be installed from [pypi](https://pypi.python.org/pypi/docker-compose)
using `pip`.  If you install using `pip` it is highly recommended that you use a<commit_msg>This guide used legacy backticks. <commit_after>---
description: How to install Docker Compose
keywords:
- compose, orchestration, install, installation, docker, documentation
menu:
  main:
    parent: workw_compose
    weight: -90
title: Install Compose
---

# Install Docker Compose

You can run Compose on OS X, Windows and 64-bit Linux. To install it, you'll need to install Docker first.

To install Compose, do the following:

1. Install Docker Engine:

     * <a href="/engine/installation/mac/" target="_blank">Mac OS X installation</a>

     * <a href="/engine/installation/windows/" target="_blank">Windows installation</a>

     * <a href="/engine/installation/ubuntulinux/" target="_blank">Ubuntu installation</a>

     * <a href="/engine/installation/" target="_blank">other system installations</a>

2. The Docker Toolbox installation includes both Engine and Compose, so Mac and Windows users are done installing. Others should continue to the next step.

3. Go to the <a href="https://github.com/docker/compose/releases" target="_blank">Compose repository release page on GitHub</a>.

4. Follow the instructions from the release page and run the `curl` command,
which the release page specifies, in your terminal.

     > Note: If you get a "Permission denied" error, your `/usr/local/bin` directory
     probably isn't writable and you'll need to install Compose as the superuser. Run
     `sudo -i`, then the two commands below, then `exit`.

     The following is an example command illustrating the format:

        curl -L "https://github.com/docker/compose/releases/download/1.8.0/docker-compose-$(uname -s)-$(uname -m)" > /usr/local/bin/docker-compose

     If you have problems installing with `curl`, see
     [Alternative Install Options](install.md#alternative-install-options).

5. Apply executable permissions to the binary:

        $ chmod +x /usr/local/bin/docker-compose

6.  Optionally, install [command completion](completion.md) for the
`bash` and `zsh` shell.

7. Test the installation.

        $ docker-compose --version
        docker-compose version: 1.8.0


## Alternative install options

### Install using pip

Compose can be installed from [pypi](https://pypi.python.org/pypi/docker-compose)
using `pip`.  If you install using `pip` it is highly recommended that you use a
{'fraction_non_alphanumeric': 0.10609676719461922, 'fraction_numerical': 0.007376871338685182, 'mean_word_length': 3.757481940144479, 'pattern_counts': {'":': 0, '<': 23, '<?xml version=': 0, '>': 27, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6842306', 'n_tokens_mistral': 1392, 'n_tokens_neox': 1267, 'n_words': 502}