Skip to content

Docker Compose

v5.2.0 Feature

This release adds 2 notable features for engineering teams evaluating rollout.

Published 1mo Containers & Orchestration
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

docker go orchestration

Affected surfaces

deps

Summary

AI summary

Broad release touches 🔧 Internal, ⚙ī¸ Dependencies, deps, and 🐛 Fixes.

Full changelog

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): github.com/docker/cli v29.6.0, github.com/docker/buildx v0.35.0, buildkit v0.31.0 by @thaJeztah in https://github.com/docker/compose/pull/13842
  • Bump compose-go to version v2.12.1 by @glours in https://github.com/docker/compose/pull/13865

New Contributors

  • @securityeng-bot[bot] made their first contribution in https://github.com/docker/compose/pull/13820
  • @caltechustc made their first contribution in https://github.com/docker/compose/pull/13810
  • @solunolab made their first contribution in https://github.com/docker/compose/pull/13823
  • @scarab-systems made their first contribution in https://github.com/docker/compose/pull/13831
  • @ptrdom made their first contribution in https://github.com/docker/compose/pull/13825
  • @rajyan made their first contribution in https://github.com/docker/compose/pull/13742
  • @Ijtihed made their first contribution in https://github.com/docker/compose/pull/13848

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

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track Docker Compose

Get notified when new releases ship.

Sign up free

About Docker Compose

Define and run multi-container applications with Docker

All releases →

Related context

Beta — feedback welcome: [email protected]