Metadata-Version: 2.1
Name: docker-compose
Version: 1.29.2
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
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
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.4
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: docopt <1,>=0.6.1
Requires-Dist: PyYAML <6,>=3.10
Requires-Dist: requests <3,>=2.20.0
Requires-Dist: texttable <2,>=0.9.0
Requires-Dist: websocket-client <1,>=0.32.0
Requires-Dist: distro <2,>=1.5.0
Requires-Dist: docker[ssh] >=5
Requires-Dist: dockerpty <1,>=0.4.1
Requires-Dist: jsonschema <4,>=2.5.1
Requires-Dist: python-dotenv <1,>=0.13.0
Requires-Dist: backports.ssl-match-hostname <4,>=3.5 ; python_version < "3.5"
Requires-Dist: cached-property <2,>=1.2.0 ; python_version < "3.8"
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
==============
[![Build Status](https://ci-next.docker.com/public/buildStatus/icon?job=compose/master)](https://ci-next.docker.com/public/job/compose/job/master/)

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

Docker Compose is a tool for running multi-container applications on Docker
defined using the [Compose file format](https://compose-spec.io).
A Compose file is used to define how the one or more containers that make up
your application are configured.
Once you have a Compose file, you can create and start your application with a
single command: `docker-compose up`.

Compose files can be used to deploy applications locally, or to the cloud on
[Amazon ECS](https://aws.amazon.com/ecs) or
[Microsoft ACI](https://azure.microsoft.com/services/container-instances/) using
the Docker CLI. You can read more about how to do this:
- [Compose for Amazon ECS](https://docs.docker.com/engine/context/ecs-integration/)
- [Compose for Microsoft ACI](https://docs.docker.com/engine/context/aci-integration/)

Where to get Docker Compose
----------------------------

### Windows and macOS

Docker Compose is included in
[Docker Desktop](https://www.docker.com/products/docker-desktop)
for Windows and macOS.

### Linux

You can download Docker Compose binaries from the
[release page](https://github.com/docker/compose/releases) on this repository.

### Using pip

If your platform is not supported, you can download Docker Compose using `pip`:

```console
pip install docker-compose
```

> **Note:** Docker Compose requires Python 3.6 or later.

Quick Start
-----------

Using Docker 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 Compose file looks like this:

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

You can find examples of Compose applications in our
[Awesome Compose repository](https://github.com/docker/awesome-compose).

For more information about the Compose format, see the
[Compose file reference](https://docs.docker.com/compose/compose-file/).

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

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

If you find an issue, please report it on the
[issue tracker](https://github.com/docker/compose/issues/new/choose).

Releasing
---------

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