# Docker Compose v5.2.0

- Product: Docker Compose (https://whatsnew.fyi/product/docker-compose)
- Vendor: Docker
- 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

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'.

---

- **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]_