ℹ️ 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.
Catalog / Containers
Docker Compose changelog
Runs an application made of several containers from one YAML file, as a plugin to the Docker CLI.
- Latest
- 5.5.0
- Shipped
- 17 Aug 202613 days ago
- Collected
- 60 releasesback to 24 May 2024
- Source
- docker/compose
- Project
- docs.docker.com
- Advisories
- 1 publishednewest 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 today, the first day on record. Collection status
Version history
5.x13 releases
ℹ️ 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)