No Description

mnowster 64a2713714 Merge pull request #2264 from mnowster/2259-unicode-error-volume-paths 10 years ago
bin 620e29b63f Rename binary to docker-compose and config file to docker-compose.yml 10 years ago
compose 5dc14f3925 Handle non-ascii chars in volume directories 10 years ago
contrib ac06366ef9 Add zsh completion for 'docker-compose --x-networking --x-network-driver' 10 years ago
docs 3a2df57f3d Merge pull request #2273 from mnowster/cross-ref-docs 10 years ago
experimental 52975eca6f Fixes 10 years ago
project c4f0f24c57 Fix release script notes about software and typos. 10 years ago
script 8306405340 On error print daemon logs 10 years ago
tests 5dc14f3925 Handle non-ascii chars in volume directories 10 years ago
.dockerignore 39cea970b8 alpine docker image for running compose and a script to pull and run it with the 10 years ago
.gitignore bbc76e6034 Convert the README to rst and fix the logo url before packaging it up for pypi. 10 years ago
.pre-commit-config.yaml 9ce1884925 Add upload to bintray from travis. 10 years ago
.travis.yml 9ce1884925 Add upload to bintray from travis. 10 years ago
CHANGELOG.md bd1373f527 Bump 1.4.2 10 years ago
CHANGES.md 478054af47 Rename CHANGES.md to CHANGELOG.md 10 years ago
CONTRIBUTING.md 31e8137452 Running a single test command updated 10 years ago
Dockerfile 07e9f6500c Pipe curl's download directly to extract/execute program to reduce number of commands 10 years ago
Dockerfile.run 4ae2a0e610 Update release scripts for release image. 10 years ago
LICENSE 99064d17dd Docker, Inc. 11 years ago
MAINTAINERS 63941b8f6c Add Mazz to MAINTAINERS 10 years ago
MANIFEST.in bbc76e6034 Convert the README to rst and fix the logo url before packaging it up for pypi. 10 years ago
README.md 379af594da Include link to github for code&issues 10 years ago
ROADMAP.md 41406cdd68 Update roadmap with state convergence 10 years ago
SWARM.md c421d23c34 Update Swarm docs 10 years ago
appveyor.yml 0e9ec8aa74 Add publish to bintray step to appveyor.yml 10 years ago
docker-compose.spec ecea79fd4e Bundle schema files 10 years ago
logo.png 0bdbb33447 include logo in README 10 years ago
requirements-build.txt 0340361f56 Upgrade pyinstaller to 3.0 10 years ago
requirements-dev.txt c1ed1efde8 Use py.test as the test runner 10 years ago
requirements.txt 7c6e7e0dce Update docker-py to 1.5.0 10 years ago
setup.py fe760a7b62 Include additional classifiers 10 years ago
tox.ini d5f5eb1924 Enable use of Docker networking with the --x-networking flag 10 years ago

README.md

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:

web:
  build: .
  ports:
   - "5000:5000"
  volumes:
   - .:/code
  links:
   - redis
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

Contributing

Build Status

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

Releasing

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