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
5.5.0

ℹ️ 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.

addedfixedchanged
5.4.0

ℹ️ 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

addedfixedchanged
5.3.1

🔧 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/

addedchanged
5.3.0

ℹ️ 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

addedfixedchanged
5.2.0

ℹ️ 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

addedfixedchanged
5.1.4

✨ 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/

addedfixedchanged
5.1.3

🐛 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

securityaddedfixed
5.1.2

🐛 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

addedfixedchanged
5.1.1

🐛 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

fixedchanged
5.1.0

🐛 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

fixedchanged
5.0.2

🐛 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

fixedchangedremoved
5.0.1

🐛 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

fixedchangedremoved
5.0.0

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

addedfixedchanged
2.x47 releases
2.40.3

🐛 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

fixedchanged
2.40.2

🐛 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

addedfixedchanged
2.40.1

🐛 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

fixedchanged
2.40.0

✨ 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

fixedchangeddeprecated
2.39.4

✨ 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

addedfixedchanged
2.39.3

✨ 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/

addedfixedchanged
2.39.2

🐛 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:

addedfixedchanged
2.39.1

🔧 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

addedchanged
2.39.0

✨ 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

addedfixedchanged
2.38.2

✨ 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

addedfixedchanged
2.38.1

✨ 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

changed
2.38.0

✨ 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

addedfixedchanged
2.37.3

✨ 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

addedfixedchanged
2.37.2

✨ 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

addedfixedchanged
2.37.1

✨ 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

addedfixedchanged
2.37.0

ℹ️ 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

addedfixedchanged
2.36.2

🐛 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

addedfixedchanged
2.36.1

✨ 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

addedfixedchanged
2.36.0

🎉 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

addedfixedchanged
2.35.1

🐛 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:

securityfixedchanged
2.35.0

🎉 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

addedfixedchanged
2.34.0

✨ 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-

addedfixedchanged
2.33.1

✨ 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

addedfixedchanged
2.33.0

[!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

addedfixedchanged
2.32.4

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

addedfixedchanged
2.32.3

⚠️ 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

fixedchanged
2.32.2

✨ 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)

securityaddedfixed
2.32.1

🐛 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

fixedchanged
2.32.0

✨ 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

addedfixedchanged
2.31.0

✨ 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

addedfixedchanged
2.30.3

🐛 Fixes Avoid starting all services on rebuild by @jhrotko (12258) ⚙️ Dependencies Bump compose-go v2.4.4 by @glours (12274)

fixedchanged
2.30.2

🐛 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

addedfixedchanged
2.30.1

🐛 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

fixedchanged
2.30.0

✨ 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

securityaddedfixed
2.29.7

🐛 Fixes fix regressions using mount API for bind mounts by @glours in https://github.com/docker/compose/pull/12141

fixedchanged
2.29.6

🐛 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)

fixedchanged
2.29.5

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)

fixedchanged
2.29.4

🐛 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

addedfixedchanged
2.29.3

✨ 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

addedfixedchanged
2.29.2

✨ 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

addedfixedchanged
2.29.1

✨ 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

fixedchanged
2.29.0

✨ 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

addedfixedchanged
2.28.1

🐛 Fixes Remove console.Terminal check and use IsTerminal from streams.Out by @vvoland in https://github.com/docker/compose/pull/11934

fixedchanged
2.28.0

⚙️ Dependencies bump docker/docker and docker/cli v27.0.1-rc.1, compose-go v2.1.3 (11926)

changed
2.27.3

⚙️ 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)

changed
2.27.2

✨ 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 (

addedfixedchanged
2.27.1

✨ 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)

addedfixedchanged