No entries match these filters. Clear filters
Docker Compose adds a top-level jobs: element for one-shot and scheduled workloads, with cron-based triggers and full dependency support︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.8.0 https://github.com/docker/compose.git
$ git checkout v5.8.0
└──▷ USE IT
Schedule a nightly database backup job that runs after the db service is healthy — declare it in your Compose file and register it with the engine.
compose.yaml
copy
services:
db:
image: postgres
jobs:
backup:
image: backup-tool
depends_on: [db]
triggers:
schedule:
- cron: "0 3 * * *"
Register scheduled jobs with the engine (requires Docker Engine 29.10+ with the jobs extension enabled via dockerd --extension-enable org.mobyproject.jobs.v0).
Trigger a job immediately outside its schedule — useful for ad-hoc runs or testing the job in CI.
copy
$ docker compose run backup
Declare one-shot or scheduled jobs in a new top-level jobs: element of your Compose file, with triggers.schedule accepting cron expressions — requires Docker Engine 29.10 or later with dockerd --extension-enable org.mobyproject.jobs.v0 for scheduling; manual jobs work on any engine.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Run docker compose up or docker compose create to register scheduled jobs with the engine, and docker compose down to remove them; the engine fires scheduled jobs on its own clock. Not checked yet Trigger a job immediately with docker compose run <job>, which starts any depends_on services first, streams logs, and returns the job's exit code. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! On an engine without jobs support (Docker Engine older than 29.10 or jobs extension not enabled), docker compose up refuses to start a project that declares scheduled jobs before creating anything.
Docker Compose adds live log streaming while --wait waits for services to become healthy︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.7.2 https://github.com/docker/compose.git
$ git checkout v5.7.2
└──▷ TRY IT
Watch live logs while Compose waits for all services to pass their healthchecks — useful in CI where silent waits make failures hard to diagnose.
copy
$ docker compose up --wait
Stream service logs in real time during docker compose up --wait instead of waiting in silence.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
1 more in Everything
Docker Compose adds --ignore-missing to push, --all-projects and --aggregate to stats, and umask service attribute support︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.7.0 https://github.com/docker/compose.git
$ git checkout v5.7.0
└──▷ TRY IT
Push all service images, silently skipping any that are not present in the local image store.
copy
$ docker compose push --ignore-missing
Watch live resource usage rolled up across every running Compose project on the host.
copy
$ docker compose stats --all-projects --aggregate
Set a restrictive file-creation mask for a service so new files inside the container are not world-readable.
compose.yaml
copy
services:
api:
image: myapp:latest
umask: '0027'
Skip images not available locally during push with the new --ignore-missing flag on docker compose push.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Monitor resource usage across all running Compose projects at once with the new --all-projects flag on docker compose stats, and roll up per-service totals with --aggregate. Not checked yet Set a service's umask attribute in compose.yaml to control the file-creation mask inside the container. Not checked yet Reuse existing dependency containers without recreating them by passing --no-recreate to docker compose run. Not checked yet Pass the --parallel concurrency limit through to BuildKit BuildKit A build engine for Docker images, maintained by Moby, that replaces the legacy Docker builder with parallel layer execution, cache mounts, and secret handling — giving cyber tools faster, more reproducible container builds. bake as --jobs when building with bake. Not checked yet
+4 more
show less
Let a service opt out of its own name as a network alias in compose.yaml. Not checked yet Docker Compose now uses the Docker Desktop Hub session for Docker Hub registry credentials automatically. Not checked yet Adds new library API capabilities: PushOptions.IgnoreMissing lets callers skip locally absent images when calling api.Compose.Push, and UpOptions.Validate() lets callers validate Up option combinations upfront, returning *api.IncompatibleOptionsError (matchable with errors.Is(err, api.ErrIncompatibleOptions) ) instead of silently ignoring them. Not checked yet api.Compose is now assembled from six smaller focused interfaces with the same method set, making it easier to implement or wrap in library code. Not checked yet
Skip images not available locally during push with the new --ignore-missing flag on docker compose push.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Monitor resource usage across all running Compose projects at once with the new --all-projects flag on docker compose stats, and roll up per-service totals with --aggregate. Not checked yet Set a service's umask attribute in compose.yaml to control the file-creation mask inside the container. Not checked yet Adds new library API capabilities: PushOptions.IgnoreMissing lets callers skip locally absent images when calling api.Compose.Push, and UpOptions.Validate() lets callers validate Up option combinations upfront, returning *api.IncompatibleOptionsError (matchable with errors.Is(err, api.ErrIncompatibleOptions) ) instead of silently ignoring them. Not checked yet
5 more in Everything
└──▷ BREAKING ON UPGRADE
!
`DownOptions.Images` is now typed as `api.ImagePruneMode`; a `string` variable passed where it was previously accepted now requires an explicit conversion.
Our best guess
!
`compose.ServiceHash`, `compose.NetworkHash`, and `compose.VolumeHash` are no longer exported; code that referenced them must switch to the internal package or remove the call.
Our best guess
!
The interactive `up` keyboard menu is no longer built by the library; callers must set `NavigationMenu: true` AND supply an implementation via compose.WithNavigationMenu(...), or no menu is displayed.
Our best guess
!
`Up` now ignores `StartOptions.Project` and operates only on the project passed directly to it; callers relying on `StartOptions.Project` must pass the project directly.
Our best guess
Docker Compose v5.6.0 adds partial jobs support, richer provider-service networking, and a more forgiving docker compose port command.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.6.0 https://github.com/docker/compose.git
$ git checkout v5.6.0
Makes PRIVATE_PORT optional for docker compose port, so the command works without specifying an internal port.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds partial support for jobs via compose-go jobs and container-spec layering; manually-triggered jobs are supported now, scheduled jobs are not yet available. Not checked yet Adds get-service-config provider request so providers can retrieve their resolved service configuration. Not checked yet Adds publish-endpoint capability that deploys a network relay for provider services. Not checked yet Adds get-relay-info so providers know where to bind for the relay. Not checked yet
+3 more
show less
Adds a dedicated network for the provider relay link, isolating relay traffic from application networks. Not checked yet Includes provider services in the image phase, with image distribution on demand. Not checked yet Warns on unsupported Compose-file attributes so unknown keys are surfaced rather than silently ignored. Not checked yet
Makes PRIVATE_PORT optional for docker compose port, so the command works without specifying an internal port.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds partial support for jobs via compose-go jobs and container-spec layering; manually-triggered jobs are supported now, scheduled jobs are not yet available. Not checked yet Adds get-service-config provider request so providers can retrieve their resolved service configuration. Not checked yet Adds publish-endpoint capability that deploys a network relay for provider services. Not checked yet Adds get-relay-info so providers know where to bind for the relay. Not checked yet
+2 more
show less
Adds a dedicated network for the provider relay link, isolating relay traffic from application networks. Not checked yet Warns on unsupported Compose-file attributes so unknown keys are surfaced rather than silently ignored. Not checked yet
1 more in Everything
Docker Compose v5.5.1 surfaces lifecycle hook output and exposes OpenTelemetry OpenTelemetry An open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. shutdown errors via --debug
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.5.1 https://github.com/docker/compose.git
$ git checkout v5.5.1
Surfaces OpenTelemetry shutdown errors when running with --debug, making tracing misconfiguration visible instead of silently swallowed. Not checked yet Captures and surfaces lifecycle hook output (stdout/stderr) directly in Compose output, so pre/post hook activity is visible without digging into container logs. Not checked yet
2 details in Everything
Docker Compose watch now supports --prune=false to retain superseded images after rebuilds.
└──▷ TRY IT
Preserve superseded image layers during iterative development to allow quick rollback or inspection without re-pulling.
copy
$ docker compose watch --prune=false
Docker Compose v5.5.0 overhauIs image digest reconciliation and makes compose pull honor pull_policy refresh windows.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.5.0 https://github.com/docker/compose.git
$ git checkout v5.5.0
└──▷ USE IT
Use a weekly pull policy so compose pull skips re-pulling images that were already pulled within the last 7 days.
compose.yaml
copy
services:
web:
image: myapp:latest
pull_policy: weekly
New image digest reconciliation logic in compose up prevents unnecessary container recreation by re-evaluating digests more accurately. Not checked yet compose pull now honors pull_policy refresh windows (daily, weekly, every_N), skipping redundant pulls within the configured window. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Existing containers may be recreated the first time you run compose up after upgrading to v5.5.0, as image digests are re-evaluated using the new reconciliation logic.
Docker Compose v5.4.0 introduces a new reconciliation model for volumes and networks lifecycle management.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.4.0 https://github.com/docker/compose.git
$ git checkout v5.4.0
Adds volume recreation modelling to the reconciliation plan, giving Compose finer control over when volumes are recreated during up. Not checked yet Adds network lifecycle modelling to the reconciliation plan, enabling Compose to track network create/remove operations as first-class steps in the deployment plan. Not checked yet
2 details in Everything
Docker Compose v5.3.0 adds native support for pre-start init containers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.3.0 https://github.com/docker/compose.git
$ git checkout v5.3.0
└──▷ USE IT
Run a setup task (e.g., DB migration) in an init container that must succeed before your app service starts.
yaml
copy
services:
app:
image: myapp:latest
depends_on:
init-migrate:
condition: service_completed_successfully
init-migrate:
image: myapp:latest
command: ["python", "manage.py", "migrate"]
x-init: true
Supports pre-start init containers, allowing services to declare initialization containers that run and complete before the main service starts. Not checked yet
1 detail in Everything
Docker Compose v5.2.0 introduces a new reconciliation algorithm and a rawsetenv message type for provider plugins.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.0 https://github.com/docker/compose.git
$ git checkout v5.2.0
New reconciliation algorithm computes a smarter plan between observed and expected state when converging Compose workloads. Not checked yet Adds rawsetenv message type for provider plugins, enabling plugins to set environment variables without interpolation. Not checked yet
2 details in Everything
Docker Compose v5.2.0 introduces a new reconciliation algorithm and a rawsetenv message type for provider plugins.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.2.0 https://github.com/docker/compose.git
$ git checkout v5.2.0
New reconciliation algorithm aligns observed state with expected state more accurately during docker compose up and related operations. Not checked yet Adds rawsetenv message type for provider plugins, enabling plugins to set environment variables without shell interpolation. Not checked yet
2 details in Everything
Docker Compose v5.1.4 adds a stop lifecycle hook for external providers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.1.4 https://github.com/docker/compose.git
$ git checkout v5.1.4
Docker Compose v5.0.2 adds down service name completion and proper handling for healthcheck.disable
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.0.2 https://github.com/docker/compose.git
$ git checkout v5.0.2
Handle healthcheck.disable: true in compose files Not checked yet
1 detail in Everything
Docker Compose v5 ships an official Go SDK, delegates builds to Docker Bake, and adds --wait to start plus new build options.
└──▷ GET THIS VERSION
copy
$ git clone --branch v5.0.0 https://github.com/docker/compose.git
$ git checkout v5.0.0
└──▷ USE IT
Skip the cache for a specific build stage (e.g., a frequently-changing deps stage) without disabling cache for the entire build.
yaml
copy
# compose.yaml snippet
services:
app:
build:
context: .
no_cache_filter:
- deps
Officially supports use as a Go SDK for embedding embedding Lists of numbers a model produces to represent the meaning of text, images or code, so similar items sit close together. They power semantic search and RAG. Compose into third-party software without requiring Docker CLI. Not checked yet Delegates all image building to Docker Bake (internal BuildKit BuildKit A build engine for Docker images, maintained by Moby, that replaces the legacy Docker builder with parallel layer execution, cache mounts, and secret handling — giving cyber tools faster, more reproducible container builds. builder removed), aligning with docker build behavior. Not checked yet Adds --wait option to the compose start command to block until services are healthy. Not checked yet Adds build.no_cache_filter support in Compose files to selectively skip cache for specific build stages. Not checked yet Introduces --insecure-registry flag (reserved for testing scenarios). Not checked yet
+2 more
show less
Runs lifecycle hooks on service restart. Not checked yet Adds LoadProject to the Compose API definition, expanding SDK surface. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! The internal BuildKit builder has been removed; builds are now fully delegated to Docker Bake. Any workflow relying on Compose's internal builder will break on upgrade.
advisory CVE-2025-62725
Oct 27, 2025
·
issue 128
CVE-2025-62725: Path Traversal via OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. Artifact Layer Annotations (affects < v2.40.2)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
Docker Compose v2.40.2 introduces a plugable UI component for user interactions via the WithPrompt interface.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.40.2 https://github.com/docker/compose.git
$ git checkout v2.40.2
Adds bake publish support for profiles and CTRL+Z backgrounding
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.40.1 https://github.com/docker/compose.git
$ git checkout v2.40.1
docker compose bake publish now correctly handles extends statements when using profiles Not checked yet Supports Ctrl+Z to suspend the command and run it in the background Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Drop support for buildx v0.16 and lower when building with bake
Docker Compose v2.40.0 lets you publish a Compose app as a portable compose.yaml + images bundle.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.40.0 https://github.com/docker/compose.git
$ git checkout v2.40.0
Docker Compose v2.39.4 adds develop.watch.initial_sync support for fine-grained file-watch control.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.39.4 https://github.com/docker/compose.git
$ git checkout v2.39.4
└──▷ USE IT
Suppress the initial bulk sync when starting a watch session, so only live file changes are propagated — useful when the container already has the correct files baked in.
yaml
copy
develop:
watch:
- path: ./src
action: sync
target: /app/src
initial_sync: false
Docker Compose v2.39.3 adds shell completions for the --progress flag.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.39.3 https://github.com/docker/compose.git
$ git checkout v2.39.3
Docker Compose v2.39.0 adds time-filtered events, FreeBSD support, model config inspection, and build provenance provenance Evidence recording where a software artifact came from and how it was built, including its source and build process. It helps a consumer check that the artifact matches a trusted build. /SBOM SBOM A software bill of materials, an inventory of the components and versions inside an application. It helps teams find affected software when a dependency has a vulnerability or licensing issue. attributes.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.39.0 https://github.com/docker/compose.git
$ git checkout v2.39.0
└──▷ TRY IT
Filter container events to a specific time window — useful for post-incident review of what happened during a deployment window.
copy
$ docker compose events --since 2025-07-01T10:00:00 --until 2025-07-01T10:30:00
Inspect only the model-related configuration in a Compose file, e.g. to validate AI model service definitions before deploying.
copy
$ docker compose config --models
Adds --since and --until flags to the events command for time-bounded event filtering. Not checked yet Adds FreeBSD platform support. Not checked yet Adds --models flag to the config command to inspect model configuration. Not checked yet Introduces provenance and sbom build attributes support for supply-chain metadata. Not checked yet Shows build progress in the terminal during watch rebuilds. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! COMPOSE_BAKE=false is deprecated and will warn on use; users relying on this flag to disable bake should plan for its removal.
Docker Compose v2.38.2 adds --networks flag to the config command for filtered network output.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.38.2 https://github.com/docker/compose.git
$ git checkout v2.38.2
└──▷ TRY IT
Inspect only the resolved network definitions in a Compose project — useful for auditing network topology without the noise of services, volumes, and other keys.
copy
$ docker compose config --networks
Docker Compose v2.38.1 adds support for model_variable in Compose files.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.38.1 https://github.com/docker/compose.git
$ git checkout v2.38.1
Supports model_variable for referencing model-provided variables in Compose configurations. Not checked yet
1 detail in Everything
Docker Compose v2.38.0 adds model support, a new volumes command, and lifts bind-mount publish restrictions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.38.0 https://github.com/docker/compose.git
$ git checkout v2.38.0
└──▷ TRY IT
List all volumes associated with the current Compose project to audit persistent storage.
copy
$ docker compose volumes
Introduces support for AI models as a new service type in Compose projects. Not checked yet Adds a new docker compose volumes command for managing project volumes. Not checked yet Removes the publish limitation on bind mounts, enabling port publishing alongside bind-mounted services. Not checked yet Mounts /var/run/docker.sock automatically for services using --use-api-socket. Not checked yet
4 details in Everything
Docker Compose v2.37.3 adds cache_to support when building with Bake.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.37.3 https://github.com/docker/compose.git
$ git checkout v2.37.3
Supports cache_to in Compose build configuration when using Bake as the build backend. Not checked yet
1 detail in Everything
Docker Compose v2.37.2 introduces use_api_socket support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.37.2 https://github.com/docker/compose.git
$ git checkout v2.37.2
Adds use_api_socket option, enabling socket-based API communication for Compose services. Not checked yet
1 detail in Everything
Docker Compose v2.37.1 adds extra_hosts support when building with Bake.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.37.1 https://github.com/docker/compose.git
$ git checkout v2.37.1
Docker Compose v2.37.0 adds Compose Bridge, bake as default builder, and platform/date details in image listings.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.37.0 https://github.com/docker/compose.git
$ git checkout v2.37.0
└──▷ TRY IT
Opt out of the new bake-based builder if your pipeline depends on the classic per-service build path.
copy
$ COMPOSE_BAKE=false docker compose up --build
Adds compose bridge subcommand for bridging Compose projects to other environments. Not checked yet Switches to bake as the default image builder, replacing the previous per-service build path (opt out with COMPOSE_BAKE=false). Not checked yet Includes platform and creation date columns when listing images. Not checked yet Adds metadata subcommand support for provider services. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! bake is now the default image builder; existing setups that rely on the prior per-service build behavior may behave differently — set COMPOSE_BAKE=false to restore the previous behavior.
Docker Compose v2.36.1 adds config --lock-image-digests, provider environment support, and array-style provider options.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.36.1 https://github.com/docker/compose.git
$ git checkout v2.36.1
└──▷ TRY IT
Freeze all service image references to exact digests before committing a compose file to production — prevents silent image changes on re-deploy.
copy
$ docker compose config --lock-image-digests
New config --lock-image-digests flag pins all service images to their current digest in the resolved config output. Not checked yet Provider options now accept an array in addition to a scalar value, enabling richer provider configuration. Not checked yet Providers can now receive environment variables, allowing secrets and runtime config to be passed to provider services. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The convert alias for the config command has been removed; scripts calling docker compose convert must be updated to use docker compose config.
Docker Compose v2.36.0 adds external binary service providers, a build --check flag, network interface naming, and COMPOSE_PROGRESS control.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.36.0 https://github.com/docker/compose.git
$ git checkout v2.36.0
└──▷ TRY IT
Validate your build configuration in CI before committing — catches misconfigured Dockerfiles or build args without running a full build.
copy
$ docker compose build --check
Suppress animated progress output in non-TTY CI environments where spinner/bar rendering produces noisy logs.
copy
$ COMPOSE_PROGRESS=plain docker compose up
Pin a Compose network to a specific host interface name for deterministic routing in multi-NIC NIC A network interface card or adapter, the hardware that connects a computer to a network. It sends and receives packets over the link. environments.
yaml
copy
networks:
mynet:
driver: bridge
interface_name: eth-compose0
Supports external binaries as service providers, enabling plugins that extend Compose behaviour via service.provider. Not checked yet Adds networks.interface_name to let you specify the host interface name for a Compose-managed network. Not checked yet Adds COMPOSE_PROGRESS environment variable to control progress output style without CLI flags. Not checked yet Introduces docker compose build --check to validate build configuration without executing a build. Not checked yet
4 details in Everything
Docker Compose v2.35.0 adds external services for Model Runner, build --print bakefile dump, image-type volumes, and new run quiet flags.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.35.0 https://github.com/docker/compose.git
$ git checkout v2.35.0
└──▷ TRY IT
Inspect the resolved Bake file Compose would use for a build — useful for debugging multi-service build graphs or handing off to docker buildx bake.
copy
$ docker compose build --print
Dump the raw compose config with all env-var placeholders intact (no substitution), handy for auditing or templating pipelines that do their own variable expansion.
copy
$ docker compose config --no-env-resolution
Run a one-off service task without any build or run output cluttering CI logs.
copy
$ docker compose run --quiet --quiet-build myservice python manage.py migrate
Adds first-class external services support to integrate Docker Model Runner into Compose projects. Not checked yet New config --no-env-resolution flag outputs compose config without interpolating environment variables. Not checked yet New build --print flag dumps the equivalent Bake file for the current build configuration. Not checked yet Adds --quiet and --quiet-build options to the run command to suppress output. Not checked yet Introduces volume.type=image to mount image contents as a volume. Not checked yet
+1 more
show less
Sets $PWD environment variable automatically within Compose service contexts. Not checked yet
6 details in Everything
Docker Compose v2.34.0 adds refresh pull policy, watch include filters, --env-from-file for run, and a first-class publish command.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.34.0 https://github.com/docker/compose.git
$ git checkout v2.34.0
└──▷ TRY IT
Inject secrets or environment variables from a local file into a one-off task container without baking them into the service definition.
copy
$ docker compose run --env-from-file ./secrets.env worker python manage.py migrate
Limit watch to only rebuild when source files under src/ change, ignoring docs, tests, or other directories.
yaml
copy
# In docker-compose.yml
services:
app:
develop:
watch:
- path: .
action: rebuild
include:
- src/
Publish a Compose stack as an OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. artifact to a registry for remote reuse.
copy
$ docker compose publish registry.example.com/myorg/mystack:latest
Supports refresh pull policy, letting services always pull a fresh image even when one is already present locally. Not checked yet Adds include field to watch configuration to filter which files trigger sync/rebuild, reducing noise from unrelated changes. Not checked yet Introduces --env-from-file flag on docker compose run to inject environment variables from a file into one-off containers. Not checked yet Promotes publish to a regular top-level Compose command for publishing Compose stacks as OCI artifacts. Not checked yet
4 details in Everything
Docker Compose v2.33.1 adds network gw_priority and enable_ipv4 support (requires Docker v28.0).
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.33.1 https://github.com/docker/compose.git
$ git checkout v2.33.1
└──▷ USE IT
Pin gateway priority and explicitly enable IPv4 on a custom network when running Docker v28.0+.
yaml
copy
networks:
mynet:
driver: bridge
driver_opts: {}
ipam:
config:
- subnet: 192.168.10.0/24
enable_ipv4: true
gw_priority: 10
Docker Compose v2.33.0 adds opt-in Bake build support, --with-env for publish, and BUILDKIT_PROGRESS control.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.33.0 https://github.com/docker/compose.git
$ git checkout v2.33.0
└──▷ TRY IT
Use Bake as the build backend for all services — useful when you want Bake's advanced build graph and caching features.
copy
$ COMPOSE_BAKE=1 docker compose build
Control build progress output style (e.g. plain logs) when building with Compose, handy in CI pipelines.
copy
$ BUILDKIT_PROGRESS=plain docker compose build
Publish a Compose app and include environment variable values in the published artifact.
copy
$ docker compose publish --with-env <image-name>
Adds opt-in Bake integration for managing builds: set COMPOSE_BAKE=1 to use Bake as the build backend instead of the internal buildkit client. Not checked yet Supports additional_context referencing another service in the Compose file, enabling cross-service build contexts. Not checked yet Adds BUILDKIT_PROGRESS environment variable support to control build progress output format. Not checked yet Adds --with-env flag to the publish command to include environment variables when publishing. Not checked yet
4 details in Everything
Docker Compose v2.32.2 adds --pull flag to the run command for on-demand image pulling.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.32.2 https://github.com/docker/compose.git
$ git checkout v2.32.2
└──▷ TRY IT
Pull the latest image before running a one-off task, ensuring your run command doesn't use a stale local image.
copy
$ docker compose run --pull always worker python manage.py migrate
Docker Compose v2.32.0 adds Bake-based builds and two new Watch actions: restart and sync+exec.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.32.0 https://github.com/docker/compose.git
$ git checkout v2.32.0
└──▷ USE IT
Trigger a container restart on file changes without rebuilding the image — useful for interpreted-language services.
yaml
copy
# docker-compose.yml
services:
app:
image: myapp
develop:
watch:
- path: ./src
action: restart
Introduces a restart watch action that restarts a container when watched files change, without rebuilding the image. Not checked yet Introduces a sync+exec watch action that syncs files into a running container then executes a command, enabling hot-reload workflows without a full restart. Not checked yet Automatically recreates containers when volume configuration changes, eliminating the need for manual intervention on volume updates. Not checked yet
3 details in Everything
Docker Compose v2.31.0 adds a commit command and delegates builds to buildx bake for improved build performance.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.31.0 https://github.com/docker/compose.git
$ git checkout v2.31.0
Adds docker compose commit command to commit container changes to an image. Not checked yet Delegates docker compose build to buildx bake, enabling richer build features and better performance. Not checked yet
2 details in Everything
Docker Compose v2.30.0 adds service hooks, a new generate alpha command, export command, CDI device support, and bind-recursive mounts.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.30.0 https://github.com/docker/compose.git
$ git checkout v2.30.0
└──▷ TRY IT
Generate a Compose configuration from an existing setup using the new alpha command.
copy
$ docker compose generate
Reference an OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. Compose artifact directly with the -f flag alongside a local override file.
copy
$ docker compose -f oci://registry.example.com/myapp:latest -f compose.override.yml up
Introduces service hooks, enabling lifecycle hook actions tied to service events. Not checked yet Adds docker compose generate as an alpha command for generating Compose configuration. Not checked yet Adds docker compose export command to export service container filesystems. Not checked yet Supports CDI (Container Device Interface) device requests via the devices key in Compose files. Not checked yet Supports bind volume option recursive for recursive bind mounts. Not checked yet
+1 more
show less
Allows the -f flag to be used with OCI Compose artifacts when specifying Compose files. Not checked yet
6 details in Everything
Docker Compose v2.29.3 allows combining bind mounts with rebuild watch actions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.29.3 https://github.com/docker/compose.git
$ git checkout v2.29.3
Docker Compose v2.29.2 adds x-initSync extension to guarantee an initial sync on watch start.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.29.2 https://github.com/docker/compose.git
$ git checkout v2.29.2
└──▷ USE IT
Force an initial sync of watched files when starting docker compose watch, so containers always start with up-to-date content even before the first file change.
yaml
copy
services:
app:
build: .
develop:
watch:
- action: sync
path: ./src
target: /app/src
x-initSync: true
Docker Compose v2.29.1 enriches JSON progress events with additional fields for better automation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.29.1 https://github.com/docker/compose.git
$ git checkout v2.29.1
Adds more fields to JSON progress events, enabling richer machine-readable output for CI/CD pipelines and tooling that parses --progress json. Not checked yet
1 detail in Everything
Docker Compose v2.29.0 adds JSON stream progress output and a --prune option for the watch command.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.29.0 https://github.com/docker/compose.git
$ git checkout v2.29.0
└──▷ TRY IT
Automatically remove orphaned containers during a watch session as services are removed from your compose file.
copy
$ docker compose watch --prune
Adds JSON stream progress writer for machine-readable output during compose operations. Not checked yet Adds --prune flag to docker compose watch, automatically removing containers for services no longer defined. Not checked yet
2 details in Everything
Adds --environment flag to the config command
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.27.2 https://github.com/docker/compose.git
$ git checkout v2.27.2
Docker Compose v2.27.1 adds gui/composeview command and --menu flag to open the Docker Desktop navigation menu.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.27.1 https://github.com/docker/compose.git
$ git checkout v2.27.1
└──▷ USE IT
Use the new gui/composeview command to trigger the Docker Desktop navigation menu from the CLI.
shell
copy
docker compose gui/composeview
Add gui/composeview as part of available commands Not checked yet Add documentation for --menu up option and COMPOSE_MENU environment var Not checked yet
2 details in Everything
Docker Compose v2.27.0 adds --abort-on-container-failure, --all-resources, and build.entitlements support
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.27.0 https://github.com/docker/compose.git
$ git checkout v2.27.0
Introduce --abort-on-container-failure flag to fail the entire compose process if any container exits with a non-zero status. Not checked yet Introduce --all-resources flag to include resources not explicitly used by services in the output or state. Not checked yet Add support for the build.entitlements field in docker-compose.yml to specify build entitlements. Not checked yet
3 details in Everything
Docker Compose v2.26.0 adds Mutagen file sync, compose annotations, config --variables, and a navigation menu.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.26.0 https://github.com/docker/compose.git
$ git checkout v2.26.0
Introduces compose config --variables subcommand to list available compose model variables Not checked yet Adds Mutagen synchronized file share integration for development workflows Not checked yet Adds support for container annotations in compose files Not checked yet
3 details in Everything
Adds --watch flag to docker compose up for file-change-driven container restarts
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.25.0 https://github.com/docker/compose.git
$ git checkout v2.25.0
└──▷ TRY IT
Develop applications by letting Docker detect file changes and restart services automatically.
copy
$ docker compose up --watch
Add --watch flag to up subcommand to automatically restart containers when source files change Not checked yet
1 detail in Everything
Adds --watch flag to docker compose up for automatic restarts on file changes.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.24.7 https://github.com/docker/compose.git
$ git checkout v2.24.7
└──▷ TRY IT
Run a service in development mode that automatically restarts whenever source code or config files are modified.
copy
$ docker compose up --watch
Ensure orphaned containers created by previous runs are cleaned up when starting a new stack.
copy
$ COMPOSE_REMOVE_ORPHANS=true docker compose up
Adds --watch flag to up to enable live reloading of containers when source files change Not checked yet Respects the COMPOSE_REMOVE_ORPHANS environment variable during up operations Not checked yet
2 details in Everything
Docker Compose v2.24.4 adds storage_opt support for volume driver options.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.24.4 https://github.com/docker/compose.git
$ git checkout v2.24.4
Docker Compose v2.24.0 adds attach, logs --index, stats command and --with-dependencies build flag
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.24.0 https://github.com/docker/compose.git
$ git checkout v2.24.0
└──▷ TRY IT
View resource consumption (CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. /Memory) for all services in the current project
copy
$ docker compose stats
Filter ps output to show only containers created by the current compose run that are not defined in the configuration (orphans)
copy
$ docker compose ps --orphans
Build a service and all of its transitive dependencies automatically
copy
$ docker compose build --with-dependencies my_service
Introduces the new docker compose attach subcommand to attach to running services Not checked yet Adds ps --orphans flag to include or exclude orphaned containers in project listings Not checked yet Adds logs --index flag to select specific replica containers from logs output Not checked yet Adds --with-dependencies flag to docker compose build for transitive dependency building Not checked yet Introduces the new docker compose stats command to view resource usage of compose services Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! service hash computation logic has been updated to fully ignore replicas/scale. Due to this change, after upgrade all services will be recreated.
Docker Compose v2.23.2 adds build.tags support to docker compose push and ensures watch builds with latest source.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.23.2 https://github.com/docker/compose.git
$ git checkout v2.23.2
push now considers build.tags when pushing images Not checked yet watch command forces a rebuild using the latest source code changes Not checked yet
2 details in Everything
Docker Compose v2.23.1 adds --resolve-image-digests flag for compose publish to seal image digests.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.23.1 https://github.com/docker/compose.git
$ git checkout v2.23.1
└──▷ USE IT
Publish your stack with pinned image digests to prevent tag drift in production environments.
shell
copy
docker compose publish --resolve-image-digests ./docker-compose.yml
Introduces the --resolve-image-digests CLI flag for the compose publish command to ensure published service images use fixed digests rather than tags. Not checked yet Rejects compose files that specify a driver or template_driver on secrets or configs entries, enforcing stricter schema validation. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Compose now rejects configuration files using secrets.*.driver, secrets.*.template_driver, configs.*.driver, or configs.*.template_driver keys that were previously accepted.! The compose start command now fails immediately if a dependency listed in the service is missing, rather than continuing execution.
Docker Compose v2.23.0 adds dry-run to publish, COMPOSE_ENV_FILES env var, and sync+restart watch action
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.23.0 https://github.com/docker/compose.git
$ git checkout v2.23.0
└──▷ TRY IT
Check what images would be published by compose publish without actually pushing them
copy
$ docker compose publish --dry-run
Load multiple environment files in addition to the default .env using the new COMPOSE_ENV_FILES variable
copy
$ COMPOSE_ENV_FILES=".env.dev,.env.local" docker compose up
Adds --dry-run flag to the compose publish command to simulate publishing without pushing images Not checked yet Introduces the COMPOSE_ENV_FILES environment variable to specify a list of .env files for Compose to load Not checked yet Adds sync+restart as a supported action in the develop.sync section of compose watch configurations Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! compose ps output is now truncated by default to align with Docker CLI; use --no-trunc to see full output
Docker Compose v2.22.0 adds publish, scale commands and --pull=policy flag
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.22.0 https://github.com/docker/compose.git
$ git checkout v2.22.0
└──▷ USE IT
Experimentally publish a service in a Compose project
shell
copy
docker compose publish <service>
Scale a specific service to 5 replicas via the new scale command
shell
copy
docker compose scale <service>=5
Adds the new publish command Experimental for publishing services Not checked yet Adds a new top-level scale command to adjust replica counts Not checked yet Adds policy option to the --pull flag to control image pulling behavior Not checked yet watch command is now generally available (GA) and can be run as docker compose watch Not checked yet
4 details in Everything
Docker Compose v2.21.0 adds multi-document YAML and remote Git file loading
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.21.0 https://github.com/docker/compose.git
$ git checkout v2.21.0
Adds support for multi-document YAML files in compose configuration Not checked yet Adds experimental include support for loading remote Compose files from Git repositories Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The format of docker compose ps output and docker compose ps --format=json output has changed to align with docker ps
Docker Compose v2.20.3 adds tar sync support for watch mode, enabling batched file event synchronization.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.20.3 https://github.com/docker/compose.git
$ git checkout v2.20.3
└──▷ USE IT
Verify tab-completion works correctly when specifying service profiles during development.
shell
copy
docker compose --profile<press-tab>
Adds shell completion for the --profile flag Not checked yet Enables the tar-based watcher implementation by default for docker compose watch Not checked yet
2 details in Everything
Adds depends_on.required attribute to compose files for conditional service dependencies
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.20.2 https://github.com/docker/compose.git
$ git checkout v2.20.2
Adds support for the depends_on.required attribute in docker-compose YAML configurations Not checked yet
1 detail in Everything
Docker Compose v2.20.0 adds compose wait command, --builder flag for buildx, and compose file include directive
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.20.0 https://github.com/docker/compose.git
$ git checkout v2.20.0
└──▷ USE IT
Build services using a specific Buildx builder instead of the default one via environment variable
shell
copy
BUILDX_BUILDER=my-builder docker compose up --build
Add docker compose wait by @ulyssessouza in https://github.com/docker/compose/pull/10742 Not checked yet Add support of --builder and BUILDX_BUILDER by @glours in https://github.com/docker/compose/pull/10745 Not checked yet Support attach by @ndeloof in https://github.com/docker/compose/pull/10700 Not checked yet Add support for include in https://github.com/compose-spec/compose-go/pull/416 Not checked yet
4 details in Everything
Docker Compose v2.19.0 adds service selection to down, --progress UI style config, and run --cap-add.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.19.0 https://github.com/docker/compose.git
$ git checkout v2.19.0
└──▷ TRY IT
Stop a specific container in a multi-service stack without tearing down the rest.
copy
$ docker compose down web-worker
Configure the CLI to display progress using a minimal, text-only interface.
copy
$ docker compose --progress plain up
Run a command with elevated capabilities for maintenance tasks.
copy
$ docker compose run --cap-add=NET_ADMIN app sh -c 'ip addr'
Adds the ability to select a specific service to stop when running docker compose down <service> Not checked yet Adds --progress flag to docker compose up and other commands to configure the progress UI style Not checked yet Adds --cap-add support to docker compose run for maintenance commands using the service image Not checked yet
3 details in Everything
Docker Compose v2.18.0 adds dry-run build, viz subcommand, --no-path-resolution, and COMPOSE_ANSI env var
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.18.0 https://github.com/docker/compose.git
$ git checkout v2.18.0
docker compose build --dry-run shows what would be built without creating any images. Not checked yet New docker compose viz subcommand for visualizing service dependencies. Not checked yet
2 details in Everything
Adds --dry-run to run, create, and down commands; improves NO_COLOR support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.17.3 https://github.com/docker/compose.git
$ git checkout v2.17.3
└──▷ TRY IT
Verify that docker compose run would work without actually starting the service
copy
$ docker compose run --dry-run myservice command arg
Simulate tearing down stacks to check what resources would be removed
copy
$ docker compose down --dry-run
--dry-run flag added to docker compose run to simulate without creating resources Not checked yet --dry-run flag added to docker compose create to validate configuration without starting services Not checked yet --dry-run flag added to docker compose down to simulate resource teardown without acting Not checked yet Supports disabling colored output via NO_COLOR environment variable instead of relying on ANSI TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! YAML boolean values must now use YAML 1.2 standard (true/false); legacy values like yes, on, True , etc., are rejected! Project names must strictly be lowercase alphanumeric, -, or _ starting with a letter/number; other characters are rejected
Docker Compose v2.17.0 adds --wait-timeout to up, additional_contexts build support, watch file delete handling, and dry-run for stop/restart/exec
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.17.0 https://github.com/docker/compose.git
$ git checkout v2.17.0
--wait-timeout flag on docker compose up controls the timeout for containers becoming healthy Not checked yet additional_contexts key in build service config supports extra Dockerfile build contexts Not checked yet ignore attribute in watch triggers excludes files or directories from triggering reloads Not checked yet File delete and rename events are now handled by the watch feature Not checked yet dry-run mode added to stop, restart, exec, pull, and push commands Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Project names must now be lowercase alphanumeric characters, -, or _ and start with a letter/number; previously allowed characters are now invalid.! Only YAML 1.2 boolean values (true / false) are accepted for compose files; deprecated YAML 1.1 values (~y|Y|yes|Yes|YES|n|N|no|No|NO|True|TRUE|False|FALSE|on|On|ON|off|Off|OFF~) are no longer supported and will cause parsing errors.! Duplicate mapping keys (<<) for merging YAML anchors are now rejected, preventing silent overrides.
Docker Compose v2.16.0 adds compose create options and experimental CLI commands
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.16.0 https://github.com/docker/compose.git
$ git checkout v2.16.0
└──▷ USE IT
Launch isolated services while automatically removing stale containers and scaling instances.
shell
copy
docker compose create --remove-orphans --scale=web=3
Build the project dependencies and push them to the registry in one atomic operation.
shell
copy
docker compose build --push
Adds --remove-orphans flag to compose create command. Not checked yet Adds --scale flag to compose create command. Not checked yet Introduces the experimental watch subcommand for source-driven service updates. Not checked yet Introduces the experimental alpha dry-run subcommand for simulation without side effects. Not checked yet Supports docker compose build --push to build and push images in a single step. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The convert command has been renamed to config.
Adds uts namespace support to Compose projects.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.15.1 https://github.com/docker/compose.git
$ git checkout v2.15.1
Add support for uts namespace Not checked yet
1 detail in Everything
Docker Compose v2.15.0 adds privileged builds and CLI flags for build/pull control
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.15.0 https://github.com/docker/compose.git
$ git checkout v2.15.0
└──▷ TRY IT
Pull services without building images that have a pre-built Dockerfile defined in the compose file
copy
$ docker compose --ignore-buildable pull
--ignore-buildable flag to ignore images marked as buildable during pull operations Not checked yet Support for the privileged attribute within the service.build section of compose files Not checked yet
2 details in Everything
Docker Compose v2.14.2 adds DOCKER_DEFAULT_PLATFORM support and dependency start detection.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.14.2 https://github.com/docker/compose.git
$ git checkout v2.14.2
└──▷ USE IT
Force all containers in a compose stack to run on ARM64 ARM64 A 64-bit CPU architecture from ARM Holdings, used in mobile chips, Apple Silicon, and cloud servers; cyber tools target it to run natively on those platforms instead of relying on emulation. regardless of host architecture.
shell
copy
DOCKER_DEFAULT_PLATFORM=linux/arm64 docker compose up -d
Uses the DOCKER_DEFAULT_PLATFORM environment variable to determine the platform when creating containers Not checked yet
1 detail in Everything
Docker Compose v2.14.1 adds --parallel, --include-deps, and --timestamp flags to improve workflow control
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.14.1 https://github.com/docker/compose.git
$ git checkout v2.14.1
└──▷ TRY IT
Push a stack and all its dependencies with a single command
copy
$ docker compose push --include-deps
Run a stack but restrict concurrency to avoid overwhelming the engine
copy
$ docker compose up --parallel 2
Adds --parallel flag to docker compose up to limit concurrent engine calls Not checked yet Adds --include-deps flag to the compose push command to also push dependent images Not checked yet Adds --timestamp option to compose up output Not checked yet
3 details in Everything
Docker Compose v2.14.0 adds oom_score_adj service field and tmpfs mode permissions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.14.0 https://github.com/docker/compose.git
$ git checkout v2.14.0
Adds oom_score_adj field to the service definition for controlling OOM OOM An out-of-memory condition: a program requests more memory than the system or device can provide. The allocation fails or the operating system may stop the process. killer priority Not checked yet Adds mode field for tmpfs mount permissions in the service definition Not checked yet
2 details in Everything
Docker Compose v2.13.0 adds --no-consistency flag to convert and --build to compose run
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.13.0 https://github.com/docker/compose.git
$ git checkout v2.13.0
└──▷ USE IT
Convert a compose file to JSON/YAML without enforcing schema consistency checks
shell
copy
docker compose convert --no-consistency docker-compose.yml
Run a service and automatically build its image if missing or out of date
shell
copy
docker compose run --build <service_name>
Adds --no-consistency flag to the convert subcommand Not checked yet Adds --build flag to compose run for building images during execution Not checked yet Displays creation warnings from the engine in CLI output Not checked yet
3 details in Everything
Docker Compose v2.12.0 adds --quiet flag to push for silent image uploads
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.12.0 https://github.com/docker/compose.git
$ git checkout v2.12.0
Docker Compose v2.11.0 adds platforms build directive and service-scoped log filtering.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.11.0 https://github.com/docker/compose.git
$ git checkout v2.11.0
Compose.yaml now accepts a platforms list to specify target architectures for images built by compose. Not checked yet
1 detail in Everything
Docker Compose v2.10.0 adds Windows/arm64 and Linux/riscv64 binary support
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.10.0 https://github.com/docker/compose.git
$ git checkout v2.10.0
Build windows/arm64 binaries Not checked yet Build linux/riscv64 binaries Not checked yet
2 details in Everything
Adds --pull flag to control image pulling behavior during deployment
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.8.0 https://github.com/docker/compose.git
$ git checkout v2.8.0
Introduces the --pull CLI argument to the compose run lifecycle to give users explicit control over when images are pulled Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! Docker Compose v2.8.0 now recreates networks, volumes, secrets, and configs with new names using - as a separator instead of _, which may prevent connection to existing resources; upgrade to v2.9.0 to resolve! Image names now use - as the default separator instead of other characters
Compose v2.6.1 adds env var secrets and respects deploy limits
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.6.1 https://github.com/docker/compose.git
$ git checkout v2.6.1
└──▷ USE IT
Control whether stale containers persist after a stack shutdown.
shell
copy
COMPOSE_REMOVE_ORPHANS=true docker compose down
Enforce resource quotas directly in the Compose file via standard deployment keys.
📍 deploy:
limits:
cpus: 0.5
memory: 50M
pids: 10
COMPOSE_REMOVE_ORPHANS env var now controls orphan cleanup on compose down Not checked yet deploy.limits.cpus and deploy.limits.pids are respected when scheduling services Not checked yet
2 details in Everything
Docker Compose v2.6.0 adds tags to build configs and DOTENV import support
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.6.0 https://github.com/docker/compose.git
$ git checkout v2.6.0
Adds the tags property to the build section in docker-compose files to specify custom image tags Not checked yet Automatically imports environment variables from .env files into the host process os environment Not checked yet
2 details in Everything
New compose down exit=0 behavior and cp to all containers
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.5.1 https://github.com/docker/compose.git
$ git checkout v2.5.1
└──▷ USE IT
Silently skip teardown steps in CI/CD pipelines if the environment was never started.
shell
copy
docker compose down; echo "Teardown complete (exit $?)"
Push a binary to every instance of a backend service for debugging or updates.
shell
copy
docker compose cp update.sh backend:/tmp/
compose down now exits with code 0 when there are no services or networks to remove. Not checked yet The compose cp command defaults to copying files to all containers of a service instead of just one. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! compose down now rejects arguments other than the service name(s), preventing accidental execution on wrong targets.
Docker Compose v2.5.0 adds build secrets support, ppc64le platform support, and pull policy enforcement.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.5.0 https://github.com/docker/compose.git
$ git checkout v2.5.0
Adds build.secrets support to define build-time secrets in compose files Not checked yet Adds pull_policy support to control image pulling behavior for services Not checked yet Adds ppc64le architecture support for docker compose binary Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The project name must now be lowercase, previously allowed mixed case
Compose v2.4.1 adds automatic Docker CLI autoremove and SSH config usage for builds.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.1 https://github.com/docker/compose.git
$ git checkout v2.4.1
Uses the Docker CLI directly to pass --autoremove flag during cleanup operations Not checked yet Respects ~/.ssh/config when building images via compose up Not checked yet
2 details in Everything
Docker Compose v2.4.0 adds SSH auth support, COMPOSE_PROJECT_NAME enforcement, and image caching flags.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.0 https://github.com/docker/compose.git
$ git checkout v2.4.0
└──▷ USE IT
Build images while forwarding the current user's SSH agent keys for cloning private dependencies.
shell
copy
docker compose --ssh default build
Force all operations (up, down, ps) to use a specific project namespace regardless of the current directory or file name.
shell
copy
COMPOSE_PROJECT_NAME=prod-env docker compose up -d
Adds --ssh flag to pass SSH authentications defined in the compose file or via CLI Not checked yet Enforces COMPOSE_PROJECT_NAME environment variable on all commands for project name consistency Not checked yet Adds cache_from, cache_to, cache_no, and pull flags to control image build caching behavior Not checked yet
3 details in Everything
Compose v2.3.4 re-enables --filter on ps command with enhanced documentation
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.3.4 https://github.com/docker/compose.git
$ git checkout v2.3.4
kill subcommand simplifies invocation by requiring only the project name argument. Not checked yet
1 detail in Everything
Adds device_cgroup_rules support and plain-text progress mode.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.3.3 https://github.com/docker/compose.git
$ git checkout v2.3.3
Adds device_cgroup_rules to the compose file format for container device cgroup configuration Not checked yet Enables plain text progress output when ansi=never environment variable is set Not checked yet
2 details in Everything
docker compose ls gains --filter and env var COMPOSE_REMOVE_ORPHANS; run/exec gain -i/-t
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.3.0 https://github.com/docker/compose.git
$ git checkout v2.3.0
└──▷ TRY IT
Force removal of orphaned containers on up without passing flags, via the new environment variable.
copy
$ COMPOSE_REMOVE_ORPHANS=true docker compose up -d
Attach a pseudo-TTY to an interactive run command.
copy
$ docker compose run -i -t service-name /bin/bash
Enables the COMPOSE_REMOVE_ORPHANS environment variable to force --remove-orphans behavior on commands that do not support the flag directly. Not checked yet Adds -i and -t flags to docker compose run and docker compose exec. Not checked yet
2 details in Everything
Docker Compose v2.2.3 adds :z/:Z SELinux SELinux A mandatory access control system built into the Linux kernel, maintained by the NSA and Red Hat, that enforces fine-grained policies restricting what processes can access, even if they run as root. labels to volumes and relaxes compose ps/cp requirements
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.2.3 https://github.com/docker/compose.git
$ git checkout v2.2.3
└──▷ USE IT
Mount a volume with SELinux labels for containers running in a restrictive environment.
shell
copy
docker compose run -v ./data:/data:Z app
Copy files from a container that has exited without needing the full project state.
shell
copy
docker compose cp stopped_container:/path/to/file ./local_path
Add :z and :Z SELinux labels to volume bind mounts Not checked yet compose images now lists images of containers that have been created but not yet started Not checked yet Propagation of GroupAdd from ServiceConfig to HostConfig so group additions are applied during container creation Not checked yet
3 details in Everything
Docker Compose v2.1.1 adds up --wait condition support and exec inherited environment variable handling.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.1.1 https://github.com/docker/compose.git
$ git checkout v2.1.1
Introduces the --wait flag for docker compose up, allowing users to specify a custom wait condition instead of the default timeout Not checked yet Adds support for inherited environment variables when using docker compose exec Not checked yet
2 details in Everything
Adds DOCKER_DEFAULT_PLATFORM, COMPOSE_COMPATIBILITY via .env, and classic builder support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.1.0 https://github.com/docker/compose.git
$ git checkout v2.1.0
Add support for DOCKER_DEFAULT_PLATFORM environment variable Not checked yet COMPOSE_COMPATIBILITY can be set by .env file Not checked yet Add support for EnableIPv6 Not checked yet
3 details in Everything
Docker Compose v2 introduces plugin-as-binary mode and SHA256 SHA256 A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. release checksums
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.1 https://github.com/docker/compose.git
$ git checkout v2.0.1
└──▷ TRY IT
Pass multiple status values to filter running and stopped containers.
copy
$ compose ps --status running --status stopped
compose can now run as a standalone binary (the docker compose subcommand is still the primary CLI entry point for most users) Not checked yet SHA256 checksums are included in every Compose v2 release Not checked yet
2 details in Everything
Docker Compose v2.0 introduces new env var ignore option, attach mode, and output flags
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.0 https://github.com/docker/compose.git
$ git checkout v2.0.0
└──▷ USE IT
Start a stack without worrying about orphaned containers left by previous runs.
shell
copy
COMPOSE_IGNORE_ORPHANS=1 docker compose up -d
Export the resolved configuration of an existing project to a file for inspection or debugging.
shell
copy
docker compose --project-name myapp config --output resolved.yaml
COMPOSE_IGNORE_ORPHANS environment variable allows ignoring orphaned containers during up/down operations. Not checked yet --project-name flag on compose exec and compose down removes the requirement for the original compose file by allowing operation against an existing project. Not checked yet compose config --output flag added to redirect configuration output to a file instead of stdout. Not checked yet build.network and build.extrahosts keys supported in the compose file format. Not checked yet compose up --attach new subcommand/flag enables attaching to the main service containers immediately on start. Not checked yet
+4 more
show less
COMPOSE_IGNORE_ORPHANS Not checked yet --project-name Not checked yet build.network Not checked yet build.extrahosts Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! Compose v2 architecture and installation instructions differ from v1; consider installing compose-switch for backward compatibility.
Docker Compose 1.29 adds profile filtering to config and depends_on conditions
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.29.0 https://github.com/docker/compose.git
$ git checkout 1.29.0
└──▷ USE IT
Generate the effective configuration for only specific profiles, ignoring others.
shell
copy
docker-compose config --profile web --profile db
Configure a service to wait until another service has exited with status 0 before starting.
yaml
copy
depends_on:
healthcheck-service:
condition: service_completed_successfully
Adds --profile flag to docker-compose config for filtering services by profile. Not checked yet Adds conditional dependency support in depends_on allowing waits for service completion. Not checked yet
2 details in Everything
Adds Nvidia GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. support via device requests, service profiles, and log/ANSI output flags
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.28.0 https://github.com/docker/compose.git
$ git checkout 1.28.0
Adds COMPOSE_PARAMIKO_SSH environment variable to enable the previous Paramiko-based SSH implementation Not checked yet Adds new flag for ANSI output control (shell) Not checked yet Adds support for Nvidia GPUs GPUs A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. via device requests in service configurations Not checked yet Adds a new flag to disable log prefixes Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The SSH connection approach changes from Paramiko to shell-out to the local SSH client (previous behavior can be restored with COMPOSE_PARAMIKO_SSH)
Docker Compose v1.27.0 unifies compose formats and adds IPC IPC Inter-process communication, ways for separate programs to exchange data or signals. Examples include pipes, sockets and shared memory. mode and env var support
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.27.0 https://github.com/docker/compose.git
$ git checkout 1.27.0
└──▷ TRY IT
Pass a specific project name to the container when using docker-compose run.
copy
$ COMPOSE_PROJECT_NAME=my-app docker-compose run service-name
Ensure docker-compose run uses the host's Docker CLI for building instead of the embedded Go builder.
copy
$ COMPOSE_DOCKER_CLI_BUILD=1 docker-compose run service-name
COMPOSE_PROJECT_NAME environment variable is now passed into containers in docker-compose run commands. Not checked yet Setting COMPOSE_DOCKER_CLI_BUILD=1 makes docker-compose run invoke the Docker CLI for building images via docker build. Not checked yet network_mode is now parsed inside the build section of services. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Docker Compose no longer supports Python 2.7.
Adds --attach-dependencies flag to docker compose up and COMPOSE_COMPATIBILITY env var
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.26.0 https://github.com/docker/compose.git
$ git checkout 1.26.0
└──▷ USE IT
Run compose up in compatibility mode for older docker engine versions.
shell
copy
export COMPOSE_COMPATIBILITY=1 && docker-compose up
Attach to dependent services' logs immediately when starting the stack.
shell
copy
docker-compose up --attach-dependencies
COMPOSE_COMPATIBILITY environment variable enables compatibility mode options. Not checked yet up subcommand gains --attach-dependencies flag to attach to dependency services. Not checked yet
2 details in Everything
Add COMPOSE_COMPATIBILITY environment variable for compatibility options
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.25.2 https://github.com/docker/compose.git
$ git checkout v1.25.2
└──▷ USE IT
Enable legacy compatibility mode for older compose file formats or behaviors.
shell
copy
COMPOSE_COMPATIBILITY=1 docker-compose up
Docker Compose 1.25.0 adds --no-interpolate, --quiet, --no-rm flags and BuildKit BuildKit A build engine for Docker images, maintained by Moby, that replaces the legacy Docker builder with parallel layer execution, cache mounts, and secret handling — giving cyber tools faster, more reproducible container builds. integration.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.25.0 https://github.com/docker/compose.git
$ git checkout 1.25.0
└──▷ TRY IT
Render the compose file structure without expanding environment variables for debugging.
copy
$ docker-compose config --no-interpolate
Enable BuildKit for all Compose build operations by setting the required environment variables.
copy
$ export DOCKER_BUILDKIT=1 COMPOSE_DOCKER_CLI_BUILD=1 && docker-compose build
docker-compose config supports --no-interpolate to disable variable interpolation in the rendered output Not checked yet docker-compose build accepts --quiet flag to suppress output during image building Not checked yet Compose now supports Docker BuildKit via environment variables DOCKER_BUILDKIT=1 and COMPOSE_DOCKER_CLI_BUILD=1 Not checked yet
3 details in Everything
Docker Compose 1.24.0 adds SSH protocol support and --all flag for ps.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.24.0 https://github.com/docker/compose.git
$ git checkout 1.24.0
└──▷ USE IT
List all containers including stopped one-off instances created by run.
shell
copy
docker-compose ps --all
Added support for connecting to the Docker Engine using the ssh protocol. Not checked yet Added a --all flag to docker-compose ps to include stopped one-off containers in the command's output. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Compose will no longer accept whitespace in variable names sourced from environment files.
Adds --hash to docker-compose config, parallel build support, and improved container naming for Docker Compose v1.23.0
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.23.0 https://github.com/docker/compose.git
$ git checkout 1.23.0
└──▷ TRY IT
Verify config integrity before deploying to detect accidental changes
copy
$ docker-compose config --hash
Speed up build pipelines by parallelizing image builds
copy
$ docker-compose build --parallel
docker-compose config now supports the --hash flag, outputting a configuration hash per service Not checked yet New --parallel flag for docker-compose build allows simultaneous image builds (up to 5) Not checked yet Container naming scheme changes from <project>_<service>_<index> to <project>_<service>_<index>_<slug> Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The default container naming format changes to include a random <slug>, breaking scripts that relied on the previous <project>_<service>_<index> pattern
Adds rollback_config, init parameter, and extension field support to Compose v3.7
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.22.0 https://github.com/docker/compose.git
$ git checkout 1.22.0
└──▷ USE IT
Define a rollback strategy for a service when using Compose file version 3.7
yaml
copy
version: '3.7'
services:
web:
image: myapp
deploy:
rollback_config:
parallelism: 2
delay: 10s
Enable the service's init process (e.g., tini) to handle signals correctly
yaml
copy
version: '3.7'
services:
app:
image: myapp
init: true
Use custom extension fields (prefixed with x-) in service, network, volume, secret, or config sections
yaml
copy
version: '3.7'
services:
db:
image: postgres
x-custom-field: custom_value
networks:
net1:
x-net-extension: true
Added rollback_config support to the deploy configuration block in Compose file format version 3.7 Not checked yet Added init parameter support in service configurations for Docker Engine 18.06.0+ Not checked yet Added support for extension fields in service, network, volume, secret, and config configurations in Compose format v3.7 Not checked yet
3 details in Everything
Docker Compose 1.21.0 adds platform, CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. real-time, workdir flags and parallel pull
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.21.0 https://github.com/docker/compose.git
$ git checkout 1.21.0
└──▷ TRY IT
Run a command inside a running service with the working directory set to /app without modifying the service definition.
copy
$ docker-compose exec --workdir /app web /bin/bash
Disable parallel pulls for older Docker Engine versions that do not support concurrent image pulls.
copy
$ docker-compose pull --no-parallel
docker-compose exec now supports the --workdir flag to set the working directory for the executed command. Not checked yet docker-compose build now supports the --compress flag to compress the build context. Not checked yet docker-compose pull runs in parallel by default; use --no-parallel to opt out and suppress the deprecation warning for --parallel. Not checked yet Compose file format 2.4 adds support for the platform parameter in service definitions to target specific architectures during deployment and build. Not checked yet Compose file format 2.2+ adds support for the cpu_rt_period and cpu_rt_runtime parameters in service definitions for real-time CPU scheduling. Not checked yet
+2 more
show less
Compose file format 2.1+ adds support for the cpu_period parameter in service definitions to restrict CPU usage intervals. Not checked yet Compose file format 2.x adds support for the isolation parameter in build configurations to specify container isolation mode (e.g., process or hyper-v). Not checked yet
7 details in Everything
Docker Compose 1.20.0 adds tmpfs.size support, --log-level CLI flag, and several new run/pull options
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.20.0 https://github.com/docker/compose.git
$ git checkout 1.20.0
└──▷ USE IT
Set the log level to debug for verbose troubleshooting of compose operations
shell
copy
docker-compose --log-level debug up -d
Pull all dependent images when running a subset of services
shell
copy
docker-compose pull --include-deps frontend
tmpfs.size property now supported in volume mappings for Compose file formats 3.6 and 2.3+ Not checked yet Top-level docker-compose command now accepts the --log-level flag (debug, info, warning, error, critical) Not checked yet --include-deps flag added to docker-compose pull to pull dependencies along with specified services Not checked yet --use-aliases flag added to docker-compose run to use network aliases declared in service config Not checked yet Long-form --detach option now available for exec, run, and up commands Not checked yet
5 details in Everything
Docker Compose 1.19 adds volume preservation control, parallel execution limits, and network priority to Compose files.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.19.0 https://github.com/docker/compose.git
$ git checkout 1.19.0
└──▷ USE IT
Recreate services and ensure dependencies are updated regardless of config changes
shell
copy
docker compose up --always-recreate-deps -d
Prevent volume data recovery for anonymous volumes during update
shell
copy
docker compose up -V
docker compose up now supports --renew-anon-volumes (-V) to prevent recovering volume data from previous containers for anonymous volumes Not checked yet Added COMPOSE_PARALLEL_LIMIT environment variable to limit simultaneous parallel operations (default 64) Not checked yet docker compose up gains --always-recreate-deps flag to force recreation of dependent services alongside their owner Not checked yet Compose files support priority key in service network mappings to define connection order Not checked yet Added ${VAR:?err} and ${VAR?err} variable interpolation syntax for mandatory variable checks Not checked yet
+2 more
show less
COMPOSE_IGNORE_ORPHANS environment variable can be set to suppress orphan container detection warnings Not checked yet COMPOSE_FORCE_WINDOWS_HOST environment variable forces parsing of volume definitions as Windows-style even on UNIX Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! On UNIX platforms, interactive run and exec commands now require the docker CLI; set COMPOSE_INTERACTIVE_NO_CLI=1 to revert
Docker Compose v1.18 adds shm_size and isolation to builds, custom resource names, --label/--timeout/--memory CLI flags
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.18.0 https://github.com/docker/compose.git
$ git checkout 1.18.0
└──▷ USE IT
Build an image with a specific memory limit using the new CLI flag.
shell
copy
docker-compose build --memory=512m
Run a service interactively with custom labels for tracking or identification.
shell
copy
docker-compose run --label version=1.0 --label env=test app
Define a build step with shared memory size and OS isolation in compose.yml.
config
copy
build:
shm_size: '1gb'
isolation: process
Adds --memory flag to docker-compose build to specify container memory limits during image builds. Not checked yet Adds --label flag to docker-compose run for setting labels on the created service instance. Not checked yet Adds --timeout flag to docker-compose down to configure the time allowed for container stopping. Not checked yet Supports shm_size parameter in build configuration sections of docker-compose.yml. Not checked yet Supports isolation parameter in service definitions within docker-compose.yml. Not checked yet
+3 more
show less
Allows custom names for network, secret, and config definitions in Compose file v3.5 and up. Not checked yet Supports extra_hosts in build configuration sections. Not checked yet Supports long syntax for volume entries in Compose file v2.3 and up. Not checked yet
8 details in Everything
Docker Compose v1.17 adds version 3.4 support, new build options, extension fields, and --no-start flag to the up command.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.17.0 https://github.com/docker/compose.git
$ git checkout 1.17.0
└──▷ USE IT
Configure a service build with new v3.4 options like cache_from, target, and network.
config
copy
services:
web:
build:
context: .
cache_from:
- myapp:latest
target: prod
network: backend
Create all defined resources (networks, volumes, containers) without automatically starting the services.
shell
copy
docker-compose up --no-start
Adds support for extension fields (x-*) in compose file versions 2.x and 3.4 Not checked yet Introduces version 3.4 of the docker-compose.yml specification with cache_from, network, and target build options Not checked yet Adds the order parameter to the update_config section in v3.4 files Not checked yet Allows setting a custom name for volumes using the name parameter in volume definitions Not checked yet Adds support for the shm_size option in build configuration for version 2.3 Not checked yet
+1 more
show less
Adds the --no-start flag to the up command to create resources without starting services Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! The create command is deprecated in favor of the new --no-start option on the up command
Docker Compose 1.16 adds version 2.3 support with target and start_period, plus --no-ansi CLI flag
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.16.0 https://github.com/docker/compose.git
$ git checkout 1.16.0
└──▷ TRY IT
Parse or validate Compose files in CI systems where ANSI output breaks parsing.
copy
$ docker-compose --no-ansi config
Adds blkio_config parameter support in service definitions for Compose file formats 2.x Not checked yet Adds name parameter to volume definitions for specifying custom volume names Not checked yet Adds target parameter support in network configurations for Compose file version 2.3 Not checked yet Adds start_period parameter support in healthcheck configurations for Compose file version 2.3 Not checked yet Adds --no-ansi CLI flag to suppress ANSI control characters in output Not checked yet
5 details in Everything
Adds network support in build sections, service:<name> pid mode, storage_opt, and --quiet flag to pull
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.15.0 https://github.com/docker/compose.git
$ git checkout 1.15.0
Adds network parameter to build configurations (v2.2+ files) Not checked yet Supports pid: service:<name> syntax in service definitions (v2.1+ files) Not checked yet Adds storage_opt parameter support in service definitions (v2.1+) for non-v3 formats Not checked yet Adds --quiet flag to docker-compose pull to suppress progress output Not checked yet
4 details in Everything
Compose 1.14 adds CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. resource keys (cpu_count, cpu_percent, cpus), build labels, and credential_spec/configs support in version 3.3.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.14.0 https://github.com/docker/compose.git
$ git checkout 1.14.0
Adds support for build labels in Compose file versions 2.1, 2.2, and 3.3. Not checked yet Adds shorthand -u flag for --user in the docker-compose exec command. Not checked yet
2 details in Everything
Docker Compose v1.13.0 adds init and scale keys to service definitions in Compose file format 2.2.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.13.0 https://github.com/docker/compose.git
$ git checkout 1.13.0
└──▷ USE IT
Launch a service defined in Compose file v2.2 with an embedded entrypoint (init) and override the replica count via CLI.
shell
copy
docker-compose up --scale myservice=5
Define a service that runs an init process and sets a default scale in docker-compose.yml (format version 2.2).
text
copy
version: '2.2'
services:
myapp:
image: alpine
init: true
scale: 3
Configure IPAM options for a network in Compose file format 2.2.
text
copy
version: '2.2'
networks:
default:
ipam:
driver: default
options:
Adds the --scale flag to docker-compose up for overriding scaling values defined in Compose file version 2.2 Not checked yet Adds support for the init key in service definitions within Compose file version 2.2 Not checked yet Adds support for the scale key in service definitions within Compose file version 2.2 Not checked yet Adds support for the options key in the ipam section of network definitions Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! docker-compose up now resets a service's scaling to its default value
Docker Compose 1.12.0 adds docker-compose images command, expanded ports/volumes syntax, and several new CLI flags.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.12.0 https://github.com/docker/compose.git
$ git checkout 1.12.0
└──▷ USE IT
Run docker-compose from a specific directory without changing the current working directory.
shell
copy
docker-compose --project-directory /path/to/project up -d
Scan for image usage in the current project to audit dependencies.
shell
copy
docker-compose images
Enable concurrent image pulling for faster startup times with multiple services.
shell
copy
docker-compose pull --parallel
Added --project-directory PATH option to docker-compose that will affect path resolution for the project Not checked yet Added support for COMPOSE_PATH_SEPARATOR environment variable Not checked yet Added a new docker-compose images command that lists images used by the current project's containers Not checked yet Added --parallel option to docker-compose pull that enables images for multiple services to be pulled simultaneously Not checked yet Added --resolve-image-digests option to docker-compose config that pins the image version for each service to a permanent digest Not checked yet
+12 more
show less
Added --volumes option to docker-compose config that lists named volumes declared for that project Not checked yet Added --build-arg option to docker-compose build Not checked yet Added --volume <volume_mapping> (shorthand -v) option to docker-compose run to declare runtime volumes to be mounted Not checked yet Added a --stop (shorthand -s) option to docker-compose rm that stops the running containers before removing them Not checked yet Added a --exit-code-from SERVICE option to docker-compose up Not checked yet Introduced version 3.2 of the docker-compose.yml specification with support for cache_from in the build section Not checked yet Added support for pids_limit in service definitions (version 2.1) Not checked yet Added support for mem_reservation in service definitions (version 2.x only) Not checked yet Added support for dns_opt in service definitions (version 2.x only) Not checked yet Added support for the new expanded ports syntax in service definitions Not checked yet Added support for the new expanded volumes syntax in service definitions Not checked yet Added support for port range to single port in port mappings Not checked yet
17 details in Everything
Adds docker-compose top subcommand and support for Compose file format v3.1 with secrets
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.11.0 https://github.com/docker/compose.git
$ git checkout 1.11.0
└──▷ USE IT
View running processes for all services in the current compose project
shell
copy
docker-compose top
Introduces the docker-compose top command to display processes running across services managed by Compose Not checked yet Adds version 3.1 of the docker-compose.yml specification, enabling secret management and requiring Docker Engine 1.13.0+ Not checked yet
2 details in Everything
Docker Compose 1.10.0 adds Compose file format version 3.0 support with healthcheck and sysctls capabilities.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.10.0 https://github.com/docker/compose.git
$ git checkout 1.10.0
Introduces version: '3.0' to .docker-compose.yml for docker stack compatibility Not checked yet Adds healthcheck parameter to service definitions in Compose file formats 2.1 and up Not checked yet Adds depends_on support for healthcheck-based container dependencies in Compose file formats 2.1 and up Not checked yet Adds sysctls parameter to service definitions in Compose file formats 2.1 and up Not checked yet Adds userns_mode parameter to service definitions in Compose file formats 2.1 and up Not checked yet
+3 more
show less
Adds identifying labels to networks created by Compose in formats 2.1 and up Not checked yet Adds identifying labels to volumes created by Compose in formats 2.1 and up Not checked yet Adds stop_grace_period option to service definitions in Compose file formats 2.0 and up Not checked yet
8 details in Everything
Docker Compose 1.9.0 adds v2.1 spec support with volume/network labels, isolation, group_add and inline variable defaults.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.9.0 https://github.com/docker/compose.git
$ git checkout 1.9.0
Adds version 2.1 of the docker-compose.yml specification for use with Docker Engine 1.12+ Not checked yet Added support for setting volume labels in docker-compose.yml via the new labels key in volume definitions Not checked yet Added support for setting network labels in docker-compose.yml via the new labels key in network definitions Not checked yet Added support for the isolation parameter in service definitions to specify container isolation mode Not checked yet Added support for link-local IPs in the service networks definitions using the link_local_ips field Not checked yet
+5 more
show less
Added support for shell-style inline defaults in variable interpolation: ${FOO-default} and ${FOO:-default} Not checked yet Added support for the group_add parameter in service definitions to add supplementary groups Not checked yet Added support for the oom_score_adj parameter in service definitions to adjust OOM OOM An out-of-memory condition: a program requests more memory than the system or device can provide. The allocation fails or the operating system may stop the process. score Not checked yet Added support for the internal parameter in network definitions to create internal-only networks Not checked yet Added support for the enable_ipv6 parameter in network definitions to enable IPv6 IPv6 The current version of the Internet Protocol, standardized by the IETF, using 128-bit addresses to replace the exhausted IPv4 space. Cyber tools target it because modern networks run dual-stack or IPv6-only. networking Not checked yet
10 details in Everything
└──▷ BREAKING ON UPGRADE
! Volume paths are no longer converted from C:\Users to /c/Users-style by default on Docker Toolbox/Machine; set the environment variable COMPOSE_CONVERT_WINDOWS_PATHS=1 to restore previous behavior
Docker Compose 1.8.0 adds bundle, push, and COMPOSE_TLS_VERSION env var.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.8.0 https://github.com/docker/compose.git
$ git checkout 1.8.0
└──▷ USE IT
Generate a bundle file for deployment with Docker Stack
shell
copy
docker-compose bundle
Push all service images to their configured registries
shell
copy
docker-compose push
Force the use of TLS 1.2 when interacting with the Docker Engine
shell
copy
COMPOSE_TLS_VERSION=TLSv1_2 docker-compose up
docker-compose bundle command that generates a bundle file for Docker Stack Not checked yet docker-compose push command to push service images to a registry Not checked yet COMPOSE_TLS_VERSION environment variable to specify TLS version for Docker Engine interaction Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! docker-compose rm now removes containers created by docker-compose run by default! Setting entrypoint on a service empties out any default command set on the image (i.e. CMD) to match docker run --entrypoint behavior
Docker Compose 1.7.0 adds .env loading, docker-compose exec, TLS flags, and parallel start
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.7.0 https://github.com/docker/compose.git
$ git checkout 1.7.0
docker-compose exec command for executing a process in a running container Not checked yet Added --remove-orphans flag to both docker-compose up and docker-compose down to remove containers for services that were removed from the Compose file Not checked yet .env file loading from the directory where it's run for environment variable defaults Not checked yet Added support for all the same TLS configuration flags used by the docker client: --tls, --tlscert, --tlskey, etc. Not checked yet COMPOSE_FILE environment variable can now contain multiple files, separated by the host system's standard path separator (: on Mac/Linux, ; on Windows) Not checked yet
+4 more
show less
Added --follow, --timestamp, and --tail flags to the docker-compose logs command Not checked yet Added the --workdir flag to docker-compose run Not checked yet docker-compose up, and docker-compose start will now start containers in parallel where possible Not checked yet Compose files now support the tmpfs and shm_size options Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! docker-compose logs no longer follows log output by default. Use -f to get the old default behaviour.! Booleans are no longer allows as values for mappings in the Compose file (for keys environment, labels and extra_hosts). Boolean values should be quoted so they become string values.
Docker Compose 1.6.1 adds network.aliases and improves volume/affinity behavior.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.1 https://github.com/docker/compose.git
$ git checkout 1.6.1
Adds support for the network.aliases config key in the Compose file to set network-scoped aliases for services Not checked yet Improves compatibility with Swarm by limiting container affinity to anonymous volumes only Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Requires Docker Engine 1.9.1 or later, or 1.10.0 if using version 2 of the Compose File format
Docker Compose 1.6 adds docker-compose events, config, create, down commands and network/volume definitions in Compose V2 format
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.0 https://github.com/docker/compose.git
$ git checkout 1.6.0
└──▷ USE IT
Monitor container lifecycle events in real-time
shell
copy
docker-compose events
Validate and print the merged, variable-resolved Compose configuration without starting anything
shell
copy
docker-compose config
Pass build arguments in a Compose V2 file
config
copy
build:
context: .
args:
buildno: 1
docker-compose events command for monitoring container events Not checked yet Compose file V2 introduces networks and volumes top-level keys alongside services Not checked yet Build-time context args are now supported under the build key in Compose V2 format Not checked yet docker-compose create creates containers without starting them Not checked yet New --abort-on-container-exit flag for the up command Not checked yet
+3 more
show less
Support for cpu_quota configuration option in Compose files Not checked yet Support for stop_signal configuration option in Compose files Not checked yet depends_on option enforces startup order between services Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! Removed experimental flags --x-networking and --x-network-driver! Compose 1.6 requires Docker Engine 1.9.1+ or 1.10.0 for Compose File format V2! Removed support for FIG_FILE, FIG_PROJECT_NAME environment variables! No longer reads fig.yml as a default Compose file location
Docker Compose 1.5.2 allows specifying a URL for the build context.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.5.2 https://github.com/docker/compose.git
$ git checkout 1.5.2
Add support for using a url as the value of build Not checked yet Improved the validation of the expose option Not checked yet
2 details in Everything
Docker Compose 1.5.1 adds --force-rm to build and ulimit support in compose files
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.5.1 https://github.com/docker/compose.git
$ git checkout 1.5.1
Adds --force-rm option to docker-compose build to force removal of intermediate containers on failure Not checked yet Adds ulimit configuration option for services within the Compose file Not checked yet Allows dashes (-) in keys under the environment service option in Compose files Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The name option is no longer accepted as a valid service option in Compose files (previously it silently overrode the actual service name)
Docker Compose 1.5.0 adds host-side env var substitution, Windows support, multi-file overrides, named volumes, and pause/unpause commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.5.0 https://github.com/docker/compose.git
$ git checkout 1.5.0
└──▷ TRY IT
Mount a named host volume by name instead of a path bind in the Compose file.
copy
$ volumes:
- mydatavolume:/data
Environment variables are now interpolated on the host in the Compose file ($VAR or ${VAR}), requiring $$ escaping for literal passes to containers Not checked yet The ipc config key is now supported in docker-compose.yml to specify an IPC IPC Inter-process communication, ways for separate programs to exchange data or signals. Examples include pipes, sockets and shared memory. namespace Not checked yet volumes_from accepts a mode suffix (e.g., servicename:ro) to mount volumes read-only Not checked yet Named host volumes can be referenced in the volumes list by name (e.g., mydatavolume:/data), enabling named volume mounts instead of only path-based binds Not checked yet docker-compose build --pull instructs Compose to pull the base image for each Dockerfile before building Not checked yet
+6 more
show less
docker-compose pull --ignore-pull-failures continues pulling if a single service's image fails, rather than aborting Not checked yet Containers created by docker-compose run can be named using the --name flag Not checked yet docker-compose run now supports a -p|--publish parameter for publishing specific ports to the host Not checked yet docker-compose pause and docker-compose unpause commands are implemented analogously to docker pause/unpause Not checked yet The extends directive now allows omitting the file option when copying configuration from another service in the same Compose file Not checked yet Compose is now available for Windows via Docker Toolbox or binary download Not checked yet
11 details in Everything
└──▷ BREAKING ON UPGRADE
! Environment variable interpolation changed from container-side to host-side: values like $VAR or ${VAR} in command: or entrypoint: fields will be replaced by host environment variables instead of remaining literal for the container; migrate by escaping with $$ (e.g., $$VAR) if a literal dollar sign is needed.! Compose 1.5.0 requires Docker 1.7.1 or later; versions prior to 1.7.1 are no longer supported.
Docker Compose 1.4.0 adds smart recreate default, custom container names, stdin configs, volume driver/log options, and parallel execution.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.4.0 https://github.com/docker/compose.git
$ git checkout 1.4.0
└──▷ TRY IT
Force a full recreation of all containers ignoring configuration changes
copy
$ docker-compose up --force-recreate
Inject YAML configuration dynamically from stdout without a file
copy
$ echo 'redis: {image: redis}' | docker-compose --file - up
Adds --force-recreate flag to force full recreation when the previous --x-smart-recreate was removed Not checked yet Removes experimental --x-smart-recreate flag which previously enabled selective container recreation Not checked yet Adds container_name field to service definitions for specifying custom container names Not checked yet Allows extends directive to omit the file option, defaulting to the current composition file Not checked yet Extends service name validation to include dots, dashes, and underscores Not checked yet
+6 more
show less
Enables reading YAML configuration from standard input by passing - as the filename argument Not checked yet Adds docker-compose version command for displaying bundled dependency information Not checked yet Adds log_opt field in docker-compose.yml to pass extra options to logging drivers Not checked yet Adds memswap_limit field in docker-compose.yml similar to --memory-swap in Docker Not checked yet Allows passing any volume mode (e.g., :z, :Z) when mounting volumes, not just :ro or :rw Not checked yet Adds volume_driver option in docker-compose.yml to specify custom volume drivers Not checked yet
11 details in Everything
└──▷ BREAKING ON UPGRADE
! The --allow-insecure-ssl flag is deprecated and has no effect; plain HTTP image pulling now works by default
Docker Compose 1.3.0 adds experimental smart recreate, new compose.yml config keys, and project root auto-discovery
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.3.0 https://github.com/docker/compose.git
$ git checkout 1.3.0
└──▷ TRY IT
Test the new smart recreate behavior that only updates services with configuration changes
copy
$ docker-compose up --x-smart-recreate
Adds --x-smart-recreate flag to docker-compose up for experimental configuration-delta-aware container recreation Not checked yet Adds dockerfile, labels, extra_hosts, pid, cpuset, read_only, security_opt, and log_driver configuration keys to docker-compose.yml Not checked yet Enables automatic project root discovery by climbing parent directories to find docker-compose.yml Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Compose now requires Docker 1.6.0 or later; installations with older Docker versions will fail! Existing containers must be removed or migrated before running your app due to changes in container tracking (labels vs names) and recreation logic
Docker Compose 1.2.0 adds extends for cross-file service inheritance, new CLI flags, and Swarm scheduling fixes
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.2.0 https://github.com/docker/compose.git
$ git checkout 1.2.0
└──▷ USE IT
Run a command as a specific user
shell
copy
docker-compose run --user 1000:1000 myservice /bin/bash
Adds extends option in docker-compose.yml to let a service inherit configuration from another service in a different configuration file Not checked yet Adds --user flag to docker-compose run to specify the user for the command Not checked yet Adds --timeout (-t) flag to up, stop, and restart commands to control graceful stop waiting period Not checked yet Adds -f shorthand for --force on docker-compose rm Not checked yet Enables net: container:<service> syntax to share another service's network namespace Not checked yet
+1 more
show less
Implements co-scheduling of dependent containers on the same Swarm node Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! Paths in build, env_file, and volumes are now resolved relative to the configuration file directory, not the working directory
Docker Compose 1.1.0 adds fig rename, --service-ports, external_links, and env_file.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.1.0 https://github.com/docker/compose.git
$ git checkout 1.1.0
Introduces docker-compose as the primary command (renamed from fig). Not checked yet Adds --service-ports flag to docker-compose run for exposing service ports. Not checked yet Adds external_links option to docker-compose.yml for linking to external containers. Not checked yet Adds --no-build option to docker-compose up to skip automatic image building. Not checked yet Makes Compose default to the latest tag when the image key lacks a specific tag. Not checked yet
+3 more
show less
Adds -s flag to docker-compose kill for sending specific signals to containers. Not checked yet Adds env_file key to docker-compose.yml for loading environment variables from files. Not checked yet Supports dns_search, cap_add, cap_drop, cpu_shares, and restart options in docker-compose.yml. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! The fig.yml config file must be renamed to docker-compose.yml.! PyPi package name changed from fig to docker-compose.
Adds --allow-insecure-ssl flag to fig up/run/pull commands
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.0.1 https://github.com/docker/compose.git
$ git checkout 1.0.1
└──▷ USE IT
Pull images from a registry using self-signed certificates without errors
shell
copy
fig pull --allow-insecure-ssl myimage:latest
Run a container from an insecure registry
shell
copy
fig run --allow-insecure-ssl myservice
Docker Compose 1.0.0 adds new subcommands, TLS support, and advanced volume/config capabilities
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.0.0 https://github.com/docker/compose.git
$ git checkout 1.0.0
└──▷ USE IT
Retrieve the mapped host port for a specific service without parsing verbose docker inspect output.
shell
copy
fig port web-server 80
Connect to the Docker daemon securely using client certificates and environment variables.
shell
copy
export DOCKER_TLS_VERIFY=1 DOCKER_CERT_PATH=~/.docker/certs; fig up -d
Run an interactive shell in a service with custom environment variables and entrypoint override.
shell
copy
fig run --env MY_VAR=value --entrypoint=/bin/bash worker
Adds the fig port command to output host port bindings for a service Not checked yet Adds the fig pull command to pull latest images for a service Not checked yet Adds the fig restart command to restart a service's containers Not checked yet Enables TLS daemon connection via DOCKER_CERT_PATH and DOCKER_TLS_VERIFY environment variables Not checked yet Adds ro mode support, tilde expansion, and environment variable expansion to volume definitions Not checked yet
+2 more
show less
Allows setting the project name via the FIG_PROJECT_NAME environment variable Not checked yet Adds --env and --entrypoint options to the fig run subcommand Not checked yet
7 details in Everything
Docker Compose 0.5.2 adds --no-cache flag to bypass build cache.
└──▷ GET THIS VERSION
copy
$ git clone --branch 0.5.2 https://github.com/docker/compose.git
$ git checkout 0.5.2
└──▷ USE IT
Force a fresh build for an image, ignoring any cached layers.
shell
copy
fig build --no-cache
Docker Compose 0.5.0 adds env variable resolution, volumes_from support and automatic link starting to fig.yml.
└──▷ GET THIS VERSION
copy
$ git clone --branch 0.5.0 https://github.com/docker/compose.git
$ git checkout 0.5.0
Adds volumes_from directive in fig.yml to mount volumes from other services or containers Not checked yet Adds blank value syntax (e.g. SESSION_SECRET:) in environment section of fig.yml to resolve variables from the host environment Not checked yet Makes fig run and fig up automatically start linked services based on dependencies Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The hostname option in fig.yml is now split into a domainname option
Docker Compose 0.4.1 adds configurable project name support
└──▷ GET THIS VERSION
copy
$ git clone --branch 0.4.1 https://github.com/docker/compose.git
$ git checkout 0.4.1
Adds name configuration option to make the project name configurable Not checked yet
1 detail in Everything
Fig adds privileged config option and updates container stop behavior in v0.4.0
└──▷ GET THIS VERSION
copy
$ git clone --branch 0.4.0 https://github.com/docker/compose.git
$ git checkout 0.4.0
fig.yml now supports the privileged configuration key to grant containers elevated privileges. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! Docker 0.8 is no longer supported; you must upgrade to Docker 0.9 or 0.10+.
Docker Compose 0.3.0 adds OS X/Linux binaries and -f flag to specify alternate fig.yml files
└──▷ GET THIS VERSION
copy
$ git clone --branch 0.3.0 https://github.com/docker/compose.git
$ git checkout 0.3.0