# Docker Compose changelog

> Define and run multi-container applications from a single YAML file.

- Vendor: Docker
- Category: Developer Tools
- Official site: https://docs.docker.com/compose/
- Tracked by: What's New (https://whatsnew.fyi/product/docker-compose)
- Harvested from: GitHub (docker/compose)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v5.4.0

- Date: 2026-08-03
- Version: v5.4.0
- Original notes: https://github.com/docker/compose/releases/tag/v5.4.0
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.4.0

- **added** — Model volume recreation in the plan for resource reconciliation
- **added** — Model network lifecycle in the plan for resource reconciliation
- **fixed** — Preserve zero-replica services during hashing
- **fixed** — Warn when service selection is silently ignored
- **fixed** — Use platform image-manifest digest instead of attested index for builds
- **fixed** — Honor --insecure-registry when up re-loads the model
- **fixed** — Pin type:image volume sources and pre_start hook images
- **fixed** — Tolerate missing env file on more runtime commands
- **fixed** — Resolve pre_start hook images alongside service images
- **fixed** — Return non-nil Content from dry-run CopyFromContainer
- **fixed** — Apply config flags to --services/--volumes/--networks/--models/--hash

##### What's Changed

> ℹ️ 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 network lifecycle in the plan by @ndeloof in https://github.com/docker/compose/pull/13966

###### 🐛 Fixes
* Fix(reconcile): preserve zero-replica services during hashing by @junhaoliao in https://github.com/docker/compose/pull/13931
* Fix(config): warn when service selection is silently ignored by @glours in https://github.com/docker/compose/pull/13950
* Fix(build): use platform image-manifest digest, not attested index by @glours in https://github.com/docker/compose/pull/13949
* Fix(oci): honor --insecure-registry when `up` re-loads the model by @ptrdom in https://github.com/docker/compose/pull/13894
* Fix(config): pin type:image volume sources and pre_start hook images by @glours in https://github.com/docker/compose/pull/13956
* Tolerate missing env file on more runtime commands by @maxproske in https://github.com/docker/compose/pull/13603
* Resolve `pre_start` hook images alongside service images by @ndeloof in https://github.com/docker/compose/pull/13937
* Fix(cp): return non-nil Content from dry-run CopyFromContainer by @glours in https://github.com/docker/compose/pull/13982
* Fix(config): apply config flags to `--services`/`--volumes`/`--networks`/`--models`/`--hash` by @glours in https://github.com/docker/compose/pull/13979
* Fix: tolerate missing env file on scale, watch and shell completion by @glours in https://github.com/docker/compose/pull/13973

###### 🔧  Internal
* README: remove Go Report Card badge by @thaJeztah in https://github.com/docker/compose/pull/13926
* Docs: adopt `AGENTS.md` standard, symlink `CLAUDE.md` to it by @glours in https://github.com/docker/compose/pull/13871
* Dockerfile: update golang image to alpine `3.23` by @thaJeztah in https://github.com/docker/compose/pull/13921
* Docs: require dated `AI_AGENT_DISCLOSURE.md`, drop committed copy by @glours in https://github.com/docker/compose/pull/13976
* CI: publish images to Docker Hub using OIDC by @glours in https://github.com/docker/compose/pull/13994

###### ⚙️ Dependencies
* Build(deps): bump github/codeql-action/upload-sarif from `4.36.2` to `4.37.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13942
* Build(deps): bump the docker-actions group across 1 directory with 4 updates by @dependabot[bot] in https://github.com/docker/compose/pull/13941
* Build(deps): bump actions/stale from `10.3.0` to `10.4.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13943
* Build(deps): bump github.com/mattn/go-shellwords from `1.0.13` to `1.0.14` by @dependabot[bot] in https://github.com/docker/compose/pull/13948
* Build(deps): bump golang.org/x/sync from `0.21.0` to `0.22.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13927
* Build(deps): bump golang.org/x/sys from `0.46.0` to `0.47.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13928
* Build(deps): bump docker/github-builder/.github/workflows/bake.yml from `1.13.0` to `1.14.0` in the docker-actions group by @dependabot[bot] in https://github.com/docker/compose/pull/13953
* Build(deps): bump google.golang.org/grpc from `1.81.1` to `1.82.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13922
* Build(deps): bump softprops/action-gh-release from `3.0.1` to `3.0.2` by @dependabot[bot] in https://github.com/docker/compose/pull/13955
* Build(deps): bump actions/setup-go from `6.5.0` to `7.0.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13960
* Build(deps): bump google.golang.org/grpc from `1.82.0` to `1.82.1` in the go_modules group across 1 directory by @dependabot[bot] in https://github.com/docker/compose/pull/13961
* Build(deps): bump github.com/docker/cli from `29.6.1+incompatible` to `29.6.2+incom

_[Truncated at 4000 characters — full notes: https://github.com/docker/compose/releases/tag/v5.4.0]_

### v5.3.1

- Date: 2026-07-07
- Version: v5.3.1
- Original notes: https://github.com/docker/compose/releases/tag/v5.3.1
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.3.1

- **changed** — Bump github.com/moby/buildkit from 0.31.0 to 0.31.1
- **changed** — Bump github.com/moby/sys/user to v0.4.1
- **changed** — Bump go.yaml.in/yaml/v4 from 4.0.0-rc.4 to 4.0.0-rc.6
- **changed** — Bump github.com/docker/cli from 29.6.0+incompatible to 29.6.1+incompatible

##### What's Changed

###### 🔧  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/compose/pull/13891
* Ci: remove unused desktop-edge-test workflow by @thaJeztah in https://github.com/docker/compose/pull/13897
* Ci: zizmor workflow by @crazy-max in https://github.com/docker/compose/pull/13901
* Ci: fix docs-upstream workflow by @crazy-max in https://github.com/docker/compose/pull/13912
* CODEOWNERS: add compose-reviewers by @thaJeztah in https://github.com/docker/compose/pull/13913
* Ci: harden GitHub Actions workflows by @glours in https://github.com/docker/compose/pull/13896
* GHA: dependabot: group docker/* actions updates by @thaJeztah in https://github.com/docker/compose/pull/13914

###### ⚙️ Dependencies

* Build(deps): bump github.com/moby/buildkit from `0.31.0` to `0.31.1` by @dependabot[bot] in https://github.com/docker/compose/pull/13892
* Build(deps): bump github.com/moby/sys/user to `v0.4.1` by @thaJeztah in https://github.com/docker/compose/pull/13893
* Build(deps): bump go.yaml.in/yaml/v4 from `4.0.0-rc.4` to `4.0.0-rc.6` by @dependabot[bot] in https://github.com/docker/compose/pull/13876
* Build(deps): bump github.com/docker/cli from `29.6.0+incompatible` to `29.6.1+incompatible` by @dependabot[bot] in https://github.com/docker/compose/pull/13895
* Build(deps): bump actions/stale from `10.2.0` to `10.3.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13902
* Build(deps): bump the docker-actions group with 3 updates by @dependabot[bot] in https://github.com/docker/compose/pull/13916
* Build(deps): bump actions/upload-artifact from `7.0.0` to `7.0.1` by @dependabot[bot] in https://github.com/docker/compose/pull/13908
* Build(deps): bump actions/setup-go from `6.3.0` to `6.5.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13907
* Build(deps): bump test-summary/action from `2.4` to `2.6` by @dependabot[bot] in https://github.com/docker/compose/pull/13903
* Build(deps): bump mxschmitt/action-tmate from `3.23` to `3.24` by @dependabot[bot] in https://github.com/docker/compose/pull/13910
* Build(deps): bump codecov/codecov-action from `5.5.3` to `7.0.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13904
* Build(deps): bump github/codeql-action/upload-sarif from `3.36.3` to `4.36.2` by @dependabot[bot] in https://github.com/docker/compose/pull/13917
* Build(deps): bump actions/checkout from `6.0.2` to `7.0.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13911

##### New Contributors
* @blackflytech made their first contribution in https://github.com/docker/compose/pull/13891

**Full Changelog**: https://github.com/docker/compose/compare/v5.3.0...v5.3.1

### v5.3.0

- Date: 2026-07-02
- Version: v5.3.0
- Original notes: https://github.com/docker/compose/releases/tag/v5.3.0
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.3.0

- **added** — Add native support for init containers
- **fixed** — Route authorizer token fetches through provided transport in OCI
- **fixed** — Scope Running events to project services
- **fixed** — Show private port in portNotFoundError message
- **fixed** — Normalize --no-TTY flag to --no-tty

##### What's Changed

> ℹ️ 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 by @glours in https://github.com/docker/compose/pull/13873
* Fix(run): scope Running events to project.Services by @glours in https://github.com/docker/compose/pull/13883

###### 🔧  Internal
* Chore: migrate cagent-action to docker-agent-action (v2.0.0) by @docker-agent in https://github.com/docker/compose/pull/13869
* Chore: migrate to docker-agent-action v2.0.1 by @docker-agent in https://github.com/docker/compose/pull/13872
* Fix(reconcile): hash resolved service refs to match executor by @glours in https://github.com/docker/compose/pull/13880
* Fix(compose/port): show private port in portNotFoundError message by @vmphase in https://github.com/docker/compose/pull/13875
* Fix(run): normalize --no-TTY flag to --no-tty by @nickjj in https://github.com/docker/compose/pull/13885

###### ⚙️ Dependencies
* Bump compose-go to version v2.13.0 by @glours in https://github.com/docker/compose/pull/13886





##### New Contributors
* @docker-agent made their first contribution in https://github.com/docker/compose/pull/13869
* @vmphase made their first contribution in https://github.com/docker/compose/pull/13875
* @nickjj made their first contribution in https://github.com/docker/compose/pull/13885

**Full Changelog**: https://github.com/docker/compose/compare/v5.2.0...v5.3.0

### v5.2.0

- Date: 2026-06-23
- Version: v5.2.0
- Original notes: https://github.com/docker/compose/releases/tag/v5.2.0
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.2.0

- **added** — Add rawsetenv message type for provider plugins
- **changed** — Introduce a new reconciliation algorithm between the observed state and the expected state
- **fixed** — Skip remote URL contexts from bake fs.read allowlist
- **fixed** — Skip validation when extracting config variables
- **fixed** — Probe stderr (not stdout) for TTY auto-detection in progress
- **fixed** — Honor env_file required: false for missing files in publish
- **fixed** — Fix progress TTY line overflow
- **fixed** — Bypass Docker Desktop proxy for loopback registries in publish
- **fixed** — Do not rebuild depends_on services on file change in watch

##### What's Changed

> ℹ️ 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
* Reconciliation plan by @ndeloof & @glours in https://github.com/docker/compose/pull/13830
* Add `rawsetenv` message type for provider plugins by @rajyan in https://github.com/docker/compose/pull/13742

###### 🐛 Fixes
* Fix(build): skip remote URL contexts from bake fs.read allowlist by @ndeloof in https://github.com/docker/compose/pull/13816
* Skip validation when extracting config variables by @scarab-systems in https://github.com/docker/compose/pull/13831
* Fix(progress): probe stderr (not stdout) for TTY auto-detection by @glours in https://github.com/docker/compose/pull/13837
* Fix(publish): honor env_file required: false for missing files by @Ijtihed in https://github.com/docker/compose/pull/13848

###### 🔧  Internal
* Docs: compose logs: add links for since/until flag descriptions by @thaJeztah in https://github.com/docker/compose/pull/13806
* Ci: add Dependabot cooldown (20260603-170456) by @securityeng-bot[bot] in https://github.com/docker/compose/pull/13820
* Docs(CLAUDE.md): note that commits must be signed off (DCO) by @ndeloof in https://github.com/docker/compose/pull/13817
* Refactor: replace Split in loops with more efficient SplitSeq and replace HasPrefix+TrimPrefix with CutPrefix by @caltechustc in https://github.com/docker/compose/pull/13810
* Chore: fix some comments to improve readability by @solunolab in https://github.com/docker/compose/pull/13823
* GHA: update docs-upstream to pin workflows by sha by @thaJeztah in https://github.com/docker/compose/pull/13834
* Docs: compose logs: add more links for flag descriptions by @thaJeztah in https://github.com/docker/compose/pull/13833
* Fix/progress tty line overflow 13595 by @glours in https://github.com/docker/compose/pull/13840
* Fix(publish): bypass Docker Desktop proxy for loopback registries by @ptrdom in https://github.com/docker/compose/pull/13825
* Watch: do not rebuild depends_on services on file change by @ndeloof in https://github.com/docker/compose/pull/13856
* pkg/e2e: fix malformed JWT in fixtures by @thaJeztah in https://github.com/docker/compose/pull/13857
* pkg/e2e: drop unused run param from getEnv by @glours in https://github.com/docker/compose/pull/13867
* Docs: `ps --format json` outputs JSON Lines, not a JSON array by @glours in https://github.com/docker/compose/pull/13868

###### ⚙️ Dependencies
* Build(deps): bump github.com/docker/cli from `29.5.1+incompatible` to `29.5.2+incompatible` by @dependabot[bot] in https://github.com/docker/compose/pull/13802
* Update to go `1.26.4` by @thaJeztah in https://github.com/docker/compose/pull/13828
* Chore(deps): github.com/containerd/typeurl/v2 `v2.3.0` by @thaJeztah in https://github.com/docker/compose/pull/13829
* Build(deps): bump golang.org/x/sync from `0.20.0` to `0.21.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13838
* Chore(deps): github.com/docker/cli `v29.5.3`, github.com/docker/buildx `v0.34.1`, buildkit `v0.30.0` by @thaJeztah in https://github.com/docker/compose/pull/13841
* Build(deps): bump golang.org/x/sys from `0.45.0` to `0.46.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13832
* Chore(deps): golang.org/x/crypto `v0.53.0` by @thaJeztah in https://github.com/docker/compose/pull/13844
* Build(deps): bump github.com/containerd/containerd/v2 from `2.2.3` to `2.2.4` in the go_modules group across 1 directory by @dependabot[bot] in https://github.com/docker/compose/pull/13804
* Chore(deps): bump github.com/containerd/containerd/v2 to `v2.2.5` by @thaJeztah in https://github.com/docker/compose/pull/13855
* Chore(deps): bump github.com/golang-jwt/jwt/v5 to `v5.3.1` by @thaJeztah in https://github.com/docker/compose/pull/13847
* Chore(deps): gith

_[Truncated at 4000 characters — full notes: https://github.com/docker/compose/releases/tag/v5.2.0]_

### v5.1.4

- Date: 2026-05-20
- Version: v5.1.4
- Original notes: https://github.com/docker/compose/releases/tag/v5.1.4
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.1.4

- **added** — Add stop lifecycle hook for external providers
- **fixed** — Route OCI artifact pulls through Docker Desktop HTTP proxy
- **fixed** — Restore stoppingEvent/stoppedEvent helpers for plugin stop hook
- **fixed** — Flag literal inline environment values in publish
- **changed** — Update go to 1.26.3
- **changed** — Bump github.com/mattn/go-shellwords from 1.0.12 to 1.0.13
- **changed** — Bump github.com/docker/cli from 29.4.0+incompatible to 29.4.2+incompatible
- **changed** — Bump github.com/moby/moby/client from 0.4.0 to 0.4.1
- **changed** — Bump github.com/docker/cli from 29.4.2+incompatible to 29.4.3+incompatible
- **changed** — Bump google.golang.org/grpc from 1.80.0 to 1.81.0
- **changed** — Bump google.golang.org/grpc from 1.81.0 to 1.81.1
- **changed** — Bump github.com/compose-spec/compose-go/v2 from 2.10.2 to 2.11.0
- **changed** — Bump github.com/docker/cli from 29.4.3+incompatible to 29.5.1+incompatible
- **changed** — Bump golang.org/x/sys from 0.42.0 to 0.44.0

##### What's Changed

###### ✨ 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/compose/pull/13770
* fix: restore stoppingEvent/stoppedEvent helpers for plugin stop hook by @glours in https://github.com/docker/compose/pull/13794
* fix(publish): flag literal inline environment values by @glours in https://github.com/docker/compose/pull/13760

###### 🔧  Internal
* ci: remove unused e2e job from merge workflow by @glours in https://github.com/docker/compose/pull/13740
* chore: update cagent-action to `v1.4.4` by @derekmisler in https://github.com/docker/compose/pull/13745
* Change verb tense in Docker Compose reference documentation by @ryanjbonnell in https://github.com/docker/compose/pull/13773
* pkg/compose: go fix by @thaJeztah in https://github.com/docker/compose/pull/13782
* refactor: code deduplication and simplification by @ndeloof in https://github.com/docker/compose/pull/13759
* fix: make e2e tests pass reliably locally with Docker Desktop by @glours in https://github.com/docker/compose/pull/13741
* refactor: drop Desktop beta-settings check; gate hint on LogsTab flag by @glours in https://github.com/docker/compose/pull/13755

###### ⚙️ Dependencies


* build(deps): bump github.com/mattn/go-shellwords from `1.0.12` to `1.0.13` by @dependabot[bot] in https://github.com/docker/compose/pull/13731
* build(deps): bump github.com/docker/cli from `29.4.0+incompatible` to `29.4.2+incompatible` by @dependabot[bot] in https://github.com/docker/compose/pull/13768
* build(deps): bump github.com/moby/moby/client from `0.4.0` to `0.4.1` by @dependabot[bot] in https://github.com/docker/compose/pull/13752
* build(deps): bump github.com/docker/cli from `29.4.2+incompatible` to `29.4.3+incompatible` by @dependabot[bot] in https://github.com/docker/compose/pull/13776
* build(deps): bump google.golang.org/grpc from `1.80.0` to `1.81.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13775
* build(deps):  update to `go 1.26.3` by @thaJeztah in https://github.com/docker/compose/pull/13783
* build(deps): bump google.golang.org/grpc from `1.81.0` to `1.81.1` by @dependabot[bot] in https://github.com/docker/compose/pull/13791
* build(deps): bump github.com/compose-spec/compose-go/v2 from `2.10.2` to `2.11.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13798
* build(deps): bump github.com/docker/cli from `29.4.3+incompatible` to `29.5.1+incompatible` by @dependabot[bot] in https://github.com/docker/compose/pull/13796
* build(deps): bump golang.org/x/sys from `0.42.0` to `0.44.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13788

##### New Contributors
* @ryanjbonnell made their first contribution in https://github.com/docker/compose/pull/13773

**Full Changelog**: https://github.com/docker/compose/compare/v5.1.3...v5.1.4

### v5.1.3

- Date: 2026-04-15
- Version: v5.1.3
- Original notes: https://github.com/docker/compose/releases/tag/v5.1.3
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.1.3

- **fixed** — Fix provider output handling and watch rebuild re-invocation
- **changed** — Bump github.com/containerd/containerd/v2 from 2.2.2 to 2.2.3

##### What's Changed
###### 🐛 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/compose/pull/13721
* Build and push Docker Desktop module image on release by @glours in https://github.com/docker/compose/pull/13726
* Fix typo in SECURITY.md by @glours in https://github.com/docker/compose/pull/13730
* Make hook hint deep links clickable using OSC 8 terminal hyperlinks by @glours in https://github.com/docker/compose/pull/13734
* Remove 'provenance' attribute' by @glours in https://github.com/docker/compose/pull/13738

###### ⚙️ Dependencies
* build(deps): bump github.com/containerd/containerd/v2 from 2.2.2 to 2.2.3 by @dependabot[bot] in https://github.com/docker/compose/pull/13737



**Full Changelog**: https://github.com/docker/compose/compare/v5.1.2...v5.1.3

### v5.1.2

- Date: 2026-04-09
- Version: v5.1.2
- Original notes: https://github.com/docker/compose/releases/tag/v5.1.2
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.1.2

- **fixed** — Fix TTY timer rendering when duration length changes
- **fixed** — Fix attach filtering
- **fixed** — Preserve ssh:// URL scheme when resolving Dockerfile path
- **fixed** — Initialize and pass envFiles map in processExtends
- **fixed** — Fix TestRunHook_ConsoleSize on macOS
- **fixed** — Restore post-connect fallback for multi-network stacks on API < 1.44
- **fixed** — Return api.ErrCanceled when user declines interactive prompts in publish
- **fixed** — Return error on non-ErrNotExist stat failures in Tar.Sync()
- **changed** — Use negotiated API version for network setup
- **changed** — Bump github.com/containerd/platforms from 1.0.0-rc.2 to 1.0.0-rc.4
- **changed** — Bump google.golang.org/grpc from 1.78.0 to 1.80.0
- **changed** — Bump github.com/moby/patternmatcher from 0.6.0 to 0.6.1
- **changed** — Bump go.opentelemetry.io/otel/sdk from 1.39.0 to 1.42.0
- **changed** — Bump github.com/docker/cli to 29.4.0
- **changed** — Bump github.com/hashicorp/go-version from 1.8.0 to 1.9.0
- **changed** — Bump github.com/docker/buildx to v0.33.0 and buildkit to v0.29.0
- **changed** — Bump github.com/moby/moby/client to v0.4.0 and moby/api to v1.54.1
- **changed** — Bump compose-go to version v2.10.2
- **changed** — Bump Go to 1.25.9
- **removed** — Remove direct dependency on docker/docker

##### What's Changed
###### 🐛 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 when resolving Dockerfile path by @ssam18 in https://github.com/docker/compose/pull/13669
* Initialize and pass envFiles map in processExtends by @Mohamed-Moumni in https://github.com/docker/compose/pull/13678
* Fix TestRunHook_ConsoleSize on macOS by @thaJeztah in https://github.com/docker/compose/pull/13686
* Restore post-connect fallback for multi-network stacks on API < 1.44 by @jotka in https://github.com/docker/compose/pull/13629
* Publish: return api.ErrCanceled when user declines interactive prompts by @ishwar170695 in https://github.com/docker/compose/pull/13674
* Return error on non-ErrNotExist stat failures in Tar.Sync() by @Lidang-Jiang in https://github.com/docker/compose/pull/13684

###### 🔧  Internal
* Refactor: thread context through publish sensitive data check by @ishwar170695 in https://github.com/docker/compose/pull/13653
* Add AI-powered PR review workflow via `docker/cagent-action` by @glours in https://github.com/docker/compose/pull/13659
* Update `cagent-action` to latest (with better permissions) by @derekmisler in https://github.com/docker/compose/pull/13665
* Pin GitHub Actions to commit SHA, remove pr-review workflow by @glours in https://github.com/docker/compose/pull/13662
* Exclude hook_test.go from Windows builds and propagate ExecStart error in runWaitExec by @pawannn in https://github.com/docker/compose/pull/13683
* Skip PR review workflow for Dependabot PRs by @glours in https://github.com/docker/compose/pull/13679
* Use negotiated API version for network setup by @glours in https://github.com/docker/compose/pull/13690
* Fix mixed assertion libraries in tests by @thaJeztah in https://github.com/docker/compose/pull/13689
* Test: use random host port for dind TLS build test by @ricardobranco777 in https://github.com/docker/compose/pull/13630
* Remove direct dependency on `docker/docker` by @glours in https://github.com/docker/compose/pull/13706

###### ⚙️ Dependencies
* Bump github.com/containerd/platforms from `1.0.0-rc.2` to `1.0.0-rc.3` by @dependabot[bot] in https://github.com/docker/compose/pull/13657
* Bump golangci-lint to `v2.11.3` and configure CLAUDE to use it on change by @ndeloof in https://github.com/docker/compose/pull/13656
* Bump google.golang.org/grpc from `1.78.0` to `1.79.3` by @dependabot[bot] in https://github.com/docker/compose/pull/13642
* Bump github.com/moby/patternmatcher from `0.6.0` to `0.6.1` by @dependabot[bot] in https://github.com/docker/compose/pull/13667
* Bump go.opentelemetry.io/otel/sdk from `1.39.0` to `1.42.0` by @glours in https://github.com/docker/compose/pull/13663
* Bump github.com/docker/cli from `29.2.1+incompatible` to `29.3.1+incompatible` by @dependabot[bot] in https://github.com/docker/compose/pull/13670
* Bump github.com/hashicorp/go-version from `1.8.0` to `1.9.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13692
* Bump github.com/docker/buildx `v0.33.0`, buildkit `v0.29.0` by @thaJeztah in https://github.com/docker/compose/pull/13693
* Bump google.golang.org/grpc from `1.79.3` to `1.80.0` by @dependabot[bot] in https://github.com/docker/compose/pull/13697
* Bump github.com/containerd/platforms from `1.0.0-rc.3` to `1.0.0-rc.4` by @dependabot[bot] in https://github.com/docker/compose/pull/13696
* Bump github.com/moby/moby/client `v0.4.0`, moby/api `v1.54.1` by @thaJeztah in https://github.com/docker/compose/pull/13708
* Bump github.com/docker/cli `v29.4.0` by @thaJeztah in https://github.com/docker/compose/pull/13707
* Bump compose-go to version `v2.10.2` by @glours in https://github.com/docker/compose/pull/13705
* Bump to Go `1.25.9` by @thaJeztah in https://github.com/docker/compose/pull/13720

##### New Contributors
*

_[Truncated at 4000 characters — full notes: https://github.com/docker/compose/releases/tag/v5.1.2]_

### v5.1.1

- Date: 2026-03-20
- Version: v5.1.1
- Original notes: https://github.com/docker/compose/releases/tag/v5.1.1
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.1.1

- **fixed** — Only pass ConsoleSize to ExecAttach when TTY is enabled
- **fixed** — Fix deadlock in ttyWriter.Done()

##### What's Changed

###### 🐛 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
* update to go1.25.8 by @thaJeztah in https://github.com/docker/compose/pull/13622
* bump github.com/moby/moby/api from 1.53.0 to 1.54.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13619
* bump golang.org/x/sys from 0.41.0 to 0.42.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13626
* bump github.com/containerd/containerd/v2 from 2.2.1 to 2.2.2 by @dependabot[bot] in https://github.com/docker/compose/pull/13631
* bump golang.org/x/sync from 0.19.0 to 0.20.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13627
* bump github.com/moby/moby/client from 0.2.2 to 0.3.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13621

##### New Contributors
* @maks2134 made their first contribution in https://github.com/docker/compose/pull/13640

**Full Changelog**: https://github.com/docker/compose/compare/v5.1.0...v5.1.1

### v5.1.0

- Date: 2026-02-24
- Version: v5.1.0
- Original notes: https://github.com/docker/compose/releases/tag/v5.1.0
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.1.0

- **fixed** — Emit container status events after network reconnection
- **fixed** — Fix potential nil pointer dereference in container event monitoring
- **fixed** — Recreate container when mounted image digest changes
- **fixed** — Fix panic in compose operations
- **fixed** — Fix invalid path error when using OCI artifacts on Windows
- **fixed** — Execute post_start hooks in docker compose run
- **fixed** — Fix panic when watch rebuilds without up
- **changed** — Update Go to 1.25.7
- **changed** — Migrate to moby modules

##### What's Changed

###### 🐛 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 https://github.com/docker/compose/pull/13551
* compose: recreate container when mounted image digest changes by @ibrahimypr in https://github.com/docker/compose/pull/13549
* fix panic by @ndeloof in https://github.com/docker/compose/pull/13562
* Fix invalid path error when using OCI artifacts on Windows by @mikesir87 in https://github.com/docker/compose/pull/13574
* fix: execute post_start hooks in docker compose run by @veeceey in https://github.com/docker/compose/pull/13607
* Fix panic when watch rebuilds without up by @maxproske in https://github.com/docker/compose/pull/13610

###### 🔧  Internal
* fsnotify is set in Dockerfile by @ndeloof in https://github.com/docker/compose/pull/13533
* Dockerfile: update golangci-lint to v2.8.0 by @thaJeztah in https://github.com/docker/compose/pull/13535
* replace some uses of strings.Split(N) for strings.Cut by @thaJeztah in https://github.com/docker/compose/pull/13542
* Upgrade GitHub Actions to latest versions by @salmanmkc in https://github.com/docker/compose/pull/13546
* pkg/compose: remove dependency on github.com/docker/buildx/driver by @thaJeztah in https://github.com/docker/compose/pull/13563
* use Docker GitHub Builder to build and sign binaries and bin image by @crazy-max in https://github.com/docker/compose/pull/13568
* ci: fix bin-image job by @crazy-max in https://github.com/docker/compose/pull/13569
* pkg/compose: defaultNetworkSettings: refactor by @thaJeztah in https://github.com/docker/compose/pull/13580
* pkg/compose: un-export consts by @thaJeztah in https://github.com/docker/compose/pull/13584
* modernize some code by @thaJeztah in https://github.com/docker/compose/pull/13588

###### ⚙️ Dependencies
* update to go1.25.7 by @thaJeztah in https://github.com/docker/compose/pull/13573
* build(deps): bump golang.org/x/sys from 0.40.0 to 0.41.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13578
* build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.3 to 4.0.0-rc.4 by @dependabot[bot] in https://github.com/docker/compose/pull/13541
* migrate to moby modules by @thaJeztah in https://github.com/docker/compose/pull/13078

##### New Contributors
* @MaheshThakur9152 made their first contribution in https://github.com/docker/compose/pull/13529
* @salmanmkc made their first contribution in https://github.com/docker/compose/pull/13546
* @Nepomuk5665 made their first contribution in https://github.com/docker/compose/pull/13551
* @ibrahimypr made their first contribution in https://github.com/docker/compose/pull/13549
* @veeceey made their first contribution in https://github.com/docker/compose/pull/13607

**Full Changelog**: https://github.com/docker/compose/compare/v5.0.2...v5.1.0

### v5.0.2

- Date: 2026-01-21
- Version: v5.0.2
- Original notes: https://github.com/docker/compose/releases/tag/v5.0.2
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.0.2

- **fixed** — Progress UI now adapts to terminal width
- **fixed** — Removed warning when no explicit build has been requested
- **fixed** — Restored runtime_flags support in models
- **added** — Added service name completion to down command
- **fixed** — Tilde in --env-file paths is now expanded to user home directory
- **fixed** — Handle healthcheck.disable: true
- **fixed** — Fixed shutdown and error handling for large file change batches in watch

##### What's Changed

###### 🐛 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
* Restored `runtime_flags` support in `models` by @ilopezluna in https://github.com/docker/compose/pull/13460
* Added service name completion to `down` command by @bmo-at in https://github.com/docker/compose/pull/13470
* Fixed tilde in `--env-file` paths expanded to user home directory by @tensorworkerr in https://github.com/docker/compose/pull/13510
* Handle `healthcheck.disable: true` by @stavros-k in https://github.com/docker/compose/pull/13494
* Fixed shutdown and error handling for large file change batches in `watch` by @amyssnippet in https://github.com/docker/compose/pull/13525


###### 🔧  Internal
* Added unit test for upOptions.OnExit method by @htoyoda18 in https://github.com/docker/compose/pull/13489
* clean up temporary compose files after conversion by @htoyoda18 in https://github.com/docker/compose/pull/13483
* Fixed typo in isSwarmEnabled method name by @htoyoda18 in https://github.com/docker/compose/pull/13481
* Fixed incorrect usage of errgroup.WithContext by @htoyoda18 in https://github.com/docker/compose/pull/13480
* Fixed timeout initialization when waitTimeout is zero by @htoyoda18 in https://github.com/docker/compose/pull/13471
* Extracted API version constants to dedicated file by @htoyoda18 in https://github.com/docker/compose/pull/13503
* Replace tabbed indentation in sdk.md by @pkqk in https://github.com/docker/compose/pull/13505
* Improved attach error handling and cleanup by @htoyoda18 in https://github.com/docker/compose/pull/13488
* Modernize tests by @dgageot in https://github.com/docker/compose/pull/13531
* set fsnotify build tag when building for OSX by @ndeloof in https://github.com/docker/compose/pull/13532

###### ⚙️ Dependencies
* build(deps): bump github.com/klauspost/compress to v1.18.2 by @thaJeztah in https://github.com/docker/compose/pull/13499
* go.mod: remove exclude rules by @thaJeztah in https://github.com/docker/compose/pull/13498
* build(deps): bump github.com/containerd/containerd/v2 to v2.2.1 by @thaJeztah in https://github.com/docker/compose/pull/13497
* build(deps): bump golang.org/x/sys from 0.39.0 to 0.40.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13502
* build(deps): bump google.golang.org/grpc from 1.77.0 to 1.78.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13475
* build(deps): bump github.com/go-viper/mapstructure/v2 from 2.4.0 to 2.5.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13506
* build(deps): bump github.com/sirupsen/logrus v1.9.4 by @thaJeztah in https://github.com/docker/compose/pull/13518
* Bump compose to v2.10.1 by @ndeloof in https://github.com/docker/compose/pull/13528

##### New Contributors
* @bmo-at made their first contribution in https://github.com/docker/compose/pull/13470
* @pkqk made their first contribution in https://github.com/docker/compose/pull/13505
* @tensorworkerr made their first contribution in https://github.com/docker/compose/pull/13510
* @stavros-k made their first contribution in https://github.com/docker/compose/pull/13494
* @amyssnippet made their first contribution in https://github.com/docker/compose/pull/13525
* @dgageot made their first contribution in https://github.com/docker/compose/pull/13531

**Full Changelog**: https://github.com/docker/compose/compare/v5.0.1...v5.0.2