ℹ️ This release adds partial support for jobs: only manually-triggered jobs are supported for now, scheduled jobs are not yet available. Full job support will land once the corresponding Docker Engine support is merged. ✨ Improvements Jobs
Catalog / Containers
Docker Compose changelog
Docker Compose is at 5.6.0, published 2 Oct 2026, 12 days ago.
Runs an application made of several containers from one YAML file, as a plugin to the Docker CLI.
- Collected
- 62 releases back to 24 May 2024
- Source
- docker/compose
- Project
- docs.docker.com
- Advisories
- 1 published newest 2025
- Feed
- RSS
Every release of a major line in one list, which is the one view the publisher never writes: 2 to 5. Only the lines whose first release the archive holds are listed, because a partial major would read as the whole of one.
Read on 28 of the 30 days on record, last today. Collection status
Version history
5.x15 releases
✨ Improvements Feat(hooks): capture and surface lifecycle hook output by @glours in https://github.com/docker/compose/pull/14091 Feat(tracing): surface otel shutdown errors via --debug by @htoyoda18 in https://github.com/docker/compose/pull
ℹ️ This release overhauls image digest reconciliation to prevent unnecessary container recreation.Existing containers may be recreated the first time you run compose up after upgrading, as image digests are re-evaluated using the new logic.
ℹ️ This release introduces a new way to reconcile resources such as volumes and networks ✨ Improvements Feat(reconcile): model volume recreation in the plan by @ndeloof in https://github.com/docker/compose/pull/13962 Feat(reconcile): model
🔧 Internal Ci: add concurrency group to pr-review-trigger to prevent duplicate reviews by @derekmisler in https://github.com/docker/compose/pull/13890 Fix grammar in Attestations field comment by @blackflytech in https://github.com/docker/
ℹ️ This release introduces native support for init containers. ✨ Improvements Pre start init containers by @glours in https://github.com/docker/compose/pull/13862 🐛 Fixes Fix(oci): route authorizer token fetches through provided transport
ℹ️ This version introduces a new reconciliation algorithm between the observed state and the expected state. If you experience any issues with a Compose workload that was previously working, please open an issue. ✨ Improvements Reconciliati
✨ Improvements feat: add stop lifecycle hook for external providers by @glours in https://github.com/docker/compose/pull/13779 🐛 Fixes fix: route OCI artifact pulls through Docker Desktop HTTP proxy by @glours in https://github.com/docker/
🐛 Fixes fix: provider output handling and watch rebuild re-invocation by @glours in https://github.com/docker/compose/pull/13732 🔧 Internal Add Docker Desktop Logs view hints and navigation shortcut by @glours in https://github.com/docker
🐛 Fixes Fix TTY timer rendering when duration length changes by @MaybeSam05 in https://github.com/docker/compose/pull/13634 Fix up attach filtering by @false200 in https://github.com/docker/compose/pull/13664 Preserve ssh:// URL scheme whe
🐛 Fixes Only pass ConsoleSize to ExecAttach when TTY is enabled by @mikesir87 in https://github.com/docker/compose/pull/13616 Fix deadlock in ttyWriter.Done() by @maks2134 in https://github.com/docker/compose/pull/13640 ⚙️ Dependencies upd
🐛 Fixes emit container status events after network reconnection (fixes #13524) by @MaheshThakur9152 in https://github.com/docker/compose/pull/13529 Fix potential nil pointer dereference in container event monitoring by @Nepomuk5665 in http
🐛 Fixes Fixed progress UI to adapt to terminal width by @ndeloof in https://github.com/docker/compose/pull/13519 Removed warning when no explicit build has been requested. by @ndeloof in https://github.com/docker/compose/pull/13493 Restore
🐛 Fixes Restored support for COMPOSE_COMPATIBILITY by @ndeloof in https://github.com/docker/compose/pull/13424 Fixed grammatical errors and improve clarity in code. by @xiaolinny in https://github.com/docker/compose/pull/13429 Fixed broken
Major changes in this release: Compose can now officially be used as a SDK to be integrated into third-party softwares Internal builder has been removed, build is delegated to Docker Bake (same as docker build command) Why "v5" ? We decided
2.x47 releases
🐛 Fixes Fix OCI compose override support by @ndeloof https://github.com/docker/compose/pull/13311 Fix help output for "exec --no-tty" option by @tonyo https://github.com/docker/compose/pull/13314 Prompt default implementation to prevent a
🐛 Fixes Compose can't create a tar with adequate uid:gid ownership by @ndeloof in https://github.com/docker/compose/pull/13299 Test digest or canonical reference, not only tag, when checking if an image is already present by @glours in htt
🐛 Fixes Write error to watcher error channel if Start() fails by @Trolldemorted in https://github.com/docker/compose/pull/13263 Fix: set PWD only if not set by @kianelbo in https://github.com/docker/compose/pull/13268 bake only interpolate
✨ Improvements publish Compose application as compose.yaml + images by @ndeloof in https://github.com/docker/compose/pull/13257 🐛 Fixes resolve secrets based on env var before executing bake by @ndeloof in https://github.com/docker/compose
✨ Improvements Add support of develop.watch.initial_sync attribute by @glours in https://github.com/docker/compose/pull/13232 🐛 Fixes Volume ls command can run without a project by @ndeloof in https://github.com/docker/compose/pull/13221 F
✨ Improvements Add completions for the --progress flag by @m4rch3n1ng in https://github.com/docker/compose/pull/13158 🐛 Fixes Add --provenance and --sbom flag to generated bake command line, by @glours in https://github.com/docker/compose/
🐛 Fixes Fix (regression): compose build render build output with tty support by @ndeloof in https://github.com/docker/compose/pull/13107 Add missing _MODEL suffix to model variable pass to dependent services of a model by @glours in https:
🔧 Internal Add info about models usage to OpenTelemetry spans by @glours in https://github.com/docker/compose/pull/13094 ⚙️ Dependencies Bump compose-go to v2.8.1 by @glours in https://github.com/docker/compose/pull/13096
✨ Improvements Add --since & --until flags to events command by @jarqvi in https://github.com/docker/compose/pull/13030 Feat(os): add FreeBSD support by @atagtm in https://github.com/docker/compose/pull/13036 Add --models flag to config com
✨ Improvements Add --networks flag to config command by @jarqvi in https://github.com/docker/compose/pull/13021 🐛 Fixes Add a Done event to model progress display by @glours in https://github.com/docker/compose/pull/13008 Fix the way we're
✨ Improvements implement model_variable by @ndeloof in https://github.com/docker/compose/pull/13001 ⚙️ Dependencies bump compose-go to version v2.7.1 by @glours in https://github.com/docker/compose/pull/13000
✨ Improvements introduce support for models by @ndeloof in https://github.com/docker/compose/pull/12976 Add volumes command by @leoperegrino in https://github.com/docker/compose/pull/12954 remove publish limitation on bind mount by @glours
✨ Improvements add support for cache_to with bake by @ndeloof in https://github.com/docker/compose/pull/12959 🐛 Fixes fix bake intergation by @ndeloof in https://github.com/docker/compose/pull/12960 don't create services passed as paramete
✨ Improvements introduce use_api_socket by @ndeloof in https://github.com/docker/compose/pull/12908 🐛 Fixes restore ContainerName in images --json by @ndeloof in https://github.com/docker/compose/pull/12943 fix panic using w shortcut on pr
✨ Improvements Add support for extra_hosts building with bake by @ndeloof in https://github.com/docker/compose/pull/12935 🐛 Fixes Fix SIGSEGV on Enable Watch by @ndeloof in https://github.com/docker/compose/pull/12909 Revert docker compose
ℹ️ bake is now used as the default images builder, if you don't want to use it you could opt-out by setting the COMPOSE_BAKE env variable to false ✨ Improvements Add compose bridge by @glours in https://github.com/docker/compose/pull/12866
🐛 Fixes Run ContainerStart sequentially by @ndeloof in https://github.com/docker/compose/pull/12851 Only use attestation when building image outside the development inner loop by @glours in https://github.com/docker/compose/pull/12853 Repo
✨ Improvements Provider.options can be an array by @ndeloof in https://github.com/docker/compose/pull/12819 Set provider environment by @ndeloof in https://github.com/docker/compose/pull/12817 Add support of debug messages in the communicat
🎉 You can now use external binaries as service provider to extend Compose behaviour. For more information about creating your own plugin check the documentation ✨ Improvements Introduce networks.interface_name by @ndeloof in https://github
🐛 Fixes Use bind API for bind mounts by @ndeloof in https://github.com/docker/compose/pull/12733 Prefer bind API by @ndeloof in https://github.com/docker/compose/pull/12734 🔧 Internal CI(bin-image): free disk space by @crazy-max in https:
🎉 1st implementation of external services feature to support Docker Model Runner in Compose by @ndeloof in https://github.com/docker/compose/pull/12692 ✨ Improvements Set $PWD (may not be supported on Windows) by @ndeloof in https://github
✨ Improvements Support refresh pull policy by @ndeloof in https://github.com/docker/compose/pull/12568 Introduced include to filter files considered by watch by @ndeloof in https://github.com/docker/compose/pull/12584 Introduced --env-from-
✨ Improvements Add support for gw_priority, enable_ipv4 (requires docker v28.0) by @thaJeztah in https://github.com/docker/compose/pull/12570 🐛 Fixes Run watch standalone if menu fails to start by @ndeloof in https://github.com/docker/comp
[!IMPORTANT] This release introduce support for Bake to manage builds as an alternative to the internal buildkit client. This new feature can be enabled by setting COMPOSE_BAKE=1 variable. Bake will become the default builder in a future re
This release fixes the version issue of v2.32.3 🔧 Internal ci: use local source for binary builds by @crazy-max in https://github.com/docker/compose/pull/12470 ci: re-use local source to build binary images by @glours in https://github.com
⚠️ This release don't display properly its version! Instead of displaying the tag the docker compose version display its commit hash. 🐛 Fixes Only override service mac if set on the main network. by @apollo13 (12439) Exclude one-off contai
✨ Improvements Add --pull to run command by @glours (12397) 🐛 Fixes Only check bind mount conflict if sync action is involved by @ndeloof (12409) When retrying to resolveOrCreateNetwork, retry with a valid network name by @gtardif (12422)
🐛 Fixes only check volume mounts for updated config by @ndeloof in https://github.com/docker/compose/pull/12386 e2e test to prevent future regression by @ndeloof in https://github.com/docker/compose/pull/12389
✨ Improvements build with bake by @ndeloof in https://github.com/docker/compose/pull/12344 introduce watch restart action by @ndeloof in https://github.com/docker/compose/pull/12375 introduce sync+exec watch action by @ndeloof in https://gi
✨ Improvements Delegate build to buildx bake by @ndeloof (12300) Add commit command by @jarqvi (12268) 🐛 Fixes Fix(config): Print service names with --no-interpolate by @idsulik (12282) Remove obsolete containers first on scale down by @nd
🐛 Fixes Avoid starting all services on rebuild by @jhrotko (12258) ⚙️ Dependencies Bump compose-go v2.4.4 by @glours (12274)
🐛 Fixes Service being declared in a profile must not trigger re-creation by @ndeloof in (12265) Remove ArtifactType from Config in OCI v1.1 definition of the artifact by @glours (12266) 🔧 Internal Add Joana Hrotko to Maintainers by @laura
🐛 Fixes Fix regression when using stdin as input of -f flag (12248) Fix regression when using multiple time the same YAML anchor in a Compose file (12247) ⚙️ Dependencies bump compose-go to version v2.4.2 by @glours in https://github.com/d
✨ Improvements Introduce service hooks by @ndeloof (12166) Introduce generate command as alpha command by @glours (12209) Add export command by @jarqvi (12120) Add support for CDI device request using devices by @ndeloof (12184) Add support
🐛 Fixes fix regressions using mount API for bind mounts by @glours in https://github.com/docker/compose/pull/12141
🐛 Fixes Don't set propagation if target engine isn't linux by @ndeloof (12138) ⚙️ Dependencies build(deps): bump docker, docker/cli to v27.3.0-rc.2 by @thaJeztah (12136)
This release fix an issue with bind mounts on WSL2 when using Docker Desktop 🐛 Fixes Set propagation default by @ndeloof (12133) 🔧 Internal Remove custom codeql workflow in favor of default setup by @temenuzhka-thede (12131)
🐛 Fixes Fixed possible nil pointer dereference by @disc (12127) Stop dependent containers before recreating diverged service by @ndeloof (12122) 🔧 Internal GHA: test against docker engine v27.3.0 by @thaJeztah (12126) Chore(watch): Add de
✨ Improvements Allow combination of bind mounts and 'rebuild' watches by @remcokranenburg (12089) 🐛 Fixes Fix(wait): Wait only until first container exit by @idsulik (12064) Prefer mount API over bind by @ndeloof (12078) Service hash must
✨ Improvements docs: Update docker compose kill usage (12041) add x-initSync to watch to always provide initial (12047) 🐛 Fixes Removes redundant condition from toAPIBuildOptions in build.go (12009) Fix stoping compose process for single c
✨ Improvements Enhance JSON progress events with more fields (12000) 🐛 Fixes Fix sorting logic by adding secondary sorting for one-off containers (11995) 🔧 Internal Test with docker engine 27.1.0 (11998) bump docker, docker/cli v27.1.0 (1
✨ Improvements Add JSON stream progress writer (11478) Add --prune option to docker-compose watch command (11932) 🐛 Fixes Exclude unnecessary resources after services have been selected (11978) Empty env variable with no value must be unse
🐛 Fixes Remove console.Terminal check and use IsTerminal from streams.Out by @vvoland in https://github.com/docker/compose/pull/11934
⚙️ Dependencies bump docker/docker and docker/cli v27.0.1-rc.1, compose-go v2.1.3 (11926)
⚙️ Dependencies build(deps): bump github.com/docker/buildx from 0.15.0 to 0.15.1 (11921) build(deps): bump github.com/spf13/cobra from 1.8.0 to 1.8.1 (11915)
✨ Improvements Add --environment flag to config command (11891) 🐛 Fixes Prevent concurrent map write relying on project immutability (11860) Fix COMPOSE_PROFILES can be set by .env file (11861) Fix: change append to use slice index in ps (
✨ Improvements Add new navigation menu to open Compose app configuration in Docker Desktop (11834) 🐛 Fixes Allow a local .env file to override compose.yaml sibling .env (11824) Fix --resolve-image-digests (11825) Fix opentelemetry (11845)