⚠️ Retirement Date Pending

Docker Compose's integration for ECS and ACI retired in November 2023. For now, our main priority in this repository are critical security fixes.

ECS users can consider using compose-ecs.

Docker Compose "Cloud Integrations"

This Compose CLI tool makes it easy to run Docker containers and Docker Compose applications in the cloud using either :

• Amazon Elastic Container Service (ECS)
• Microsoft Azure Container Instances (ACI)
• Kubernetes (Work in progress)

...using the Docker commands you already know.

⚠️ Compose v2 (a.k.a "Local Docker Compose") has Moved

This repository is about "Cloud Integrations", the Docker Compose v2 code has moved to github.com/docker/compose

Getting started

To get started with Compose CLI, all you need is:

• macOS, Windows, or Windows WSL2: The current release of Docker Desktop
• Linux: Install script
• An AWS or Azure account in order to use the Compose Cloud integration

Please create issues to leave feedback.

Examples

• ECS: Deploying Wordpress to the cloud
• ACI: Deploying a Minecraft server to the cloud
• ACI: Setting Up Cloud Deployments Using Docker, Azure and Github Actions

Development

See the instructions in BUILDING.md for how to build the CLI and run its tests; including the end to end tests for local containers, ACI, and ECS. The guide also includes instructions for releasing the CLI.

Before contributing, please read the contribution guidelines which includes conventions used in this project.