Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/docker/compose
Define and run multi-container applications with Docker
https://github.com/docker/compose
docker docker-compose go golang orchestration
Last synced: 7 days ago
JSON representation
Define and run multi-container applications with Docker
- Host: GitHub
- URL: https://github.com/docker/compose
- Owner: docker
- License: apache-2.0
- Created: 2013-12-09T11:40:58.000Z (about 11 years ago)
- Default Branch: main
- Last Pushed: 2024-12-19T10:23:50.000Z (25 days ago)
- Last Synced: 2024-12-30T11:37:15.975Z (14 days ago)
- Topics: docker, docker-compose, go, golang, orchestration
- Language: Go
- Homepage: https://docs.docker.com/compose/
- Size: 25.1 MB
- Stars: 34,327
- Watchers: 722
- Forks: 5,271
- Open Issues: 111
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome - compose - Define and run multi-container applications with Docker (Python)
- awesome-go - docker/compose - container applications with Docker|29,372| (Popular)
- awesome-docker-compose - Docker Compose
- Self-Hosting-Guide - Docker Compose - container applications. With Compose, we can create a YAML file to define the services and with a single command, can spin everything up or tear it all down. (Tools for Self-Hosting / Containers)
- awesome-whatthefar - docker-compose
- awesome-repositories - docker/compose - Define and run multi-container applications with Docker (Go)
- awesome-starred - compose - Define and run multi-container applications with Docker (Python)
- django-awesome - x
- awesome-golang-repositories - compose - container applications with Docker (Repositories)
- awesome-list - Docker Compose - Define and run multi-container applications with Docker. (DevOps / Data Management)
- awesome-list - compose - container applications with Docker | docker | 23179 | (Python)
- awesome-learning - docker/compose
- awesome-list-docker - compose - container applications with Docker (python)
- my-awesome - docker / compose - :white_check_mark: Define and run multi-container applications with Docker. (Project/Product)
- awesome-python-applications - Repo - container Docker applications. `(linux, windows, mac, corp)` (<a id="tag-dev" href="#tag-dev">Dev</a> / <a id="tag-dev-other" href="#tag-dev-other">Other Dev projects</a>)
- StarryDivineSky - docker/compose
- awesome-ubuntu - Docker Compose
- awesome-starred - docker/compose - Define and run multi-container applications with Docker (Go)
- awesome-starred - docker/compose - Define and run multi-container applications with Docker (Go)
- best-of-python - GitHub - 3% open · ⏱️ 05.06.2024): (Infrastructure & DevOps)
- jimsghstars - docker/compose - Define and run multi-container applications with Docker (Go)
- awesome-starred - docker/compose - Define and run multi-container applications with Docker (golang)
README
# Table of Contents
- [Docker Compose v2](#docker-compose-v2)
- [Where to get Docker Compose](#where-to-get-docker-compose)
+ [Windows and macOS](#windows-and-macos)
+ [Linux](#linux)
- [Quick Start](#quick-start)
- [Contributing](#contributing)
- [Legacy](#legacy)
# Docker Compose v2
[](https://github.com/docker/compose/releases/latest)
[](https://pkg.go.dev/github.com/docker/compose/v2)
[](https://github.com/docker/compose/actions?query=workflow%3Aci)
[](https://goreportcard.com/report/github.com/docker/compose/v2)
[](https://codecov.io/gh/docker/compose)
[](https://api.securityscorecards.dev/projects/github.com/docker/compose)
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 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`.
# 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.
Rename the relevant binary for your OS to `docker-compose` and copy it to `$HOME/.docker/cli-plugins`
Or copy it into one of these folders to install it system-wide:
* `/usr/local/lib/docker/cli-plugins` OR `/usr/local/libexec/docker/cli-plugins`
* `/usr/lib/docker/cli-plugins` OR `/usr/libexec/docker/cli-plugins`
(might require making the downloaded file executable with `chmod +x`)
Quick Start
-----------
Using Docker Compose is 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 `compose.yaml` 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
```
Contributing
------------
Want to help develop Docker Compose? Check out our
[contributing documentation](CONTRIBUTING.md).
If you find an issue, please report it on the
[issue tracker](https://github.com/docker/compose/issues/new/choose).
Legacy
-------------
The Python version of Compose is available under the `v1` [branch](https://github.com/docker/compose/tree/v1).