Metadata-Version: 2.1
Name: docker-compose
Version: 1.27.4
Summary: Multi-container orchestration for Docker
Home-page: https://www.docker.com/
Author: Docker, Inc.
License: Apache License 2.0
Project-URL: Documentation, https://docs.docker.com/compose/overview
Project-URL: Changelog, https://github.com/docker/compose/blob/release/CHANGELOG.md
Project-URL: Source, https://github.com/docker/compose
Project-URL: Tracker, https://github.com/docker/compose/issues
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.4
Description-Content-Type: text/markdown
Requires-Dist: PyYAML (<6,>=3.10)
Requires-Dist: cached-property (<2,>=1.2.0)
Requires-Dist: distro (<2,>=1.5.0)
Requires-Dist: docker[ssh] (<5,>=4.3.1)
Requires-Dist: dockerpty (<1,>=0.4.1)
Requires-Dist: docopt (<1,>=0.6.1)
Requires-Dist: jsonschema (<4,>=2.5.1)
Requires-Dist: python-dotenv (<1,>=0.13.0)
Requires-Dist: requests (<3,>=2.20.0)
Requires-Dist: texttable (<2,>=0.9.0)
Requires-Dist: websocket-client (<1,>=0.32.0)
Requires-Dist: backports.ssl-match-hostname (<4,>=3.5) ; python_version < "3.5"
Requires-Dist: colorama (<1,>=0.4) ; sys_platform == "win32"
Provides-Extra: socks
Requires-Dist: PySocks (!=1.5.7,<2,>=1.5.6) ; extra == 'socks'
Provides-Extra: tests
Requires-Dist: ddt (<2,>=1.2.2) ; extra == 'tests'
Requires-Dist: pytest (<6) ; extra == 'tests'

Docker Compose
==============
![Docker Compose](logo.png?raw=true "Docker Compose Logo")

Compose is a tool for defining and running multi-container Docker applications.
With Compose, you use a Compose file to configure your application's services.
Then, using a single command, you create and start all the services
from your configuration. To learn more about all the features of Compose
see [the list of features](https://github.com/docker/docker.github.io/blob/master/compose/index.md#features).

Compose is great for development, testing, and staging environments, as well as
CI workflows. You can learn more about each case in
[Common Use Cases](https://github.com/docker/docker.github.io/blob/master/compose/index.md#common-use-cases).

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:

    version: '2'

    services:
      web:
        build: .
        ports:
         - "5000:5000"
        volumes:
         - .:/code
      redis:
        image: redis

For more information about the Compose file, see the
[Compose file reference](https://github.com/docker/docker.github.io/blob/master/compose/compose-file/compose-versioning.md).

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
------------------------------

- Full documentation is available on [Docker's website](https://docs.docker.com/compose/).
- Code repository for Compose is on [GitHub](https://github.com/docker/compose).
- If you find any problems please fill out an [issue](https://github.com/docker/compose/issues/new/choose). Thank you!

Contributing
------------

[![Build Status](https://ci-next.docker.com/public/buildStatus/icon?job=compose/master)](https://ci-next.docker.com/public/job/compose/job/master/)

Want to help build Compose? Check out our [contributing documentation](https://github.com/docker/compose/blob/master/CONTRIBUTING.md).

Releasing
---------

Releases are built by maintainers, following an outline of the [release process](https://github.com/docker/compose/blob/master/project/RELEASE-PROCESS.md).


