Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Define and run multi-container applications with Docker
Python Shell PowerShell
Failed to load latest commit information.
bin Rename binary to docker-compose and config file to docker-compose.yml
compose Improve boolean warning message.
contrib/completion Merge pull request #2032 from villlem/master
docs Merge pull request #2157 from mnowster/2151-missing-port-range
experimental Fixes
project Update release scripts for release image.
script Update release script and image name.
tests Improve boolean warning message.
.dockerignore alpine docker image for running compose and a script to pull and run …
.gitignore Configure PyInstaller using docker-compose.spec
.pre-commit-config.yaml Add more github label areas. Bump 1.4.2 Rename to Running a single test command updated
Dockerfile Trim the dockerfile and re-use the virtualenv we already have. Update release scripts for release image.
LICENSE Docker, Inc.
MAINTAINERS Add Mazz to MAINTAINERS Fix schema.json entry include logo in README Update roadmap with state convergence Update Swarm docs
appveyor.yml Fix building the binary on appveyor, and have it create an artifact.
docker-compose.spec Bundle schema files
logo.png include logo in README
requirements-build.txt Split requirements-build.txt from requirements-dev.txt to support a l…
requirements-dev.txt Use py.test as the test runner
requirements.txt Update docker-py to 1.4.0 Update docker-py to 1.4.0
tox.ini Pass all DOCKER_ env vars to py.test

Docker Compose

Docker Compose

(Previously known as Fig)

Compose is a tool for defining and running multi-container applications with Docker. With Compose, you define a multi-container application in a single file, then spin your application up in a single command which does everything that needs to be done to get it running.

Compose is great for development environments, staging servers, and CI. We don't recommend that you use it in production yet.

Using Compose is basically a three-step process.

  1. Define your app's environment with a Dockerfile so it can be reproduced anywhere.
  2. Define the services that make up your app in docker-compose.yml so they can be run together in an isolated environment:
  3. Lastly, run docker-compose up and Compose will start and run your entire app.

A docker-compose.yml looks like this:

  build: .
   - "5000:5000"
   - .:/code
   - redis
  image: redis

Compose has commands for managing the whole lifecycle of your application:

  • Start, stop and rebuild services
  • View the status of running services
  • Stream the log output of running services
  • Run a one-off command on a service

Installation and documentation


Build Status

Want to help build Compose? Check out our contributing documentation.


Releases are built by maintainers, following an outline of the release process.

Something went wrong with that request. Please try again.