# Docker Compose v5.5.1

- Product: Docker Compose (https://whatsnew.fyi/product/docker-compose)
- Vendor: Docker
- Date: 2026-09-03
- Version: v5.5.1
- Original notes: https://github.com/docker/compose/releases/tag/v5.5.1
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.5.1

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** — Capture and surface lifecycle hook output
- **added** — Surface otel shutdown errors via --debug
- **fixed** — Validate service names before subscribing to events
- **fixed** — Resolve bake target names collision for services differing by . vs _
- **fixed** — Sync into a symlinked directory instead of failing
- **fixed** — Include hook output in the error when a hook fails
- **fixed** — Fix TTY progress on Windows by handing the real stdout to buildkit
- **fixed** — Sync all files on initial_sync, regardless of mtime
- **fixed** — Pass IPAM options when creating networks
- **fixed** — Honor psFormat from Docker CLI config when no --format flag given
- **fixed** — Surface dependency wait timeout properly
- **fixed** — Exclude Dockerfile and compose files from initial sync
- **fixed** — Stop ttyWriter.Done from hanging after context cancel
- **fixed** — Honor provenance/sbom false in per-service bake attest
- **fixed** — Reject unknown subcommands under bridge/transformations
- **fixed** — Honor PATHEXT for provider lookup on Windows
- **fixed** — Stop swallowing SetRecursive errors via nolint
- **fixed** — Confirm before wiping non-empty convert output dir
- **fixed** — Spare dangling images of orphaned services, like their tagged image

##### What's Changed
###### ✨ Improvements
* Feat(hooks): capture and surface lifecycle hook output by @glours in https://github.com/docker/compose/pull/14091
* Feat(tracing): surface otel shutdown errors via `--debug` by @htoyoda18 in https://github.com/docker/compose/pull/14152

###### 🐛 Fixes
* Fix(events): validate service names before subscribing to events by @glours in https://github.com/docker/compose/pull/14076
* Fix: bake target names collision for services differing by `.` vs `_` by @ndeloof in https://github.com/docker/compose/pull/14058
* Fix(watch): sync into a symlinked directory instead of failing by @Endika in https://github.com/docker/compose/pull/14084
* Fix(hooks): include hook output in the error when a hook fails by @dennislapchenko in https://github.com/docker/compose/pull/14088
* Fix(build): TTY progress on Windows — hand the real stdout to buildkit by @ndeloof in https://github.com/docker/compose/pull/14090
* Fix(watch): sync all files on `initial_sync`, regardless of mtime by @glours in https://github.com/docker/compose/pull/14096
* Fix(network): pass IPAM options when creating networks by @glours in https://github.com/docker/compose/pull/14094
* Fix(ps): honor psFormat from Docker CLI config when no `--format` flag given by @glours in https://github.com/docker/compose/pull/14095
* Fix: dependency wait timeout surfaced only by luck by @ndeloof in https://github.com/docker/compose/pull/14105
* Fix: hold startMx on the start path actually exercised by @ndeloof in https://github.com/docker/compose/pull/14106
* Fix(watch): exclude Dockerfile and compose files from initial sync by @htoyoda18 in https://github.com/docker/compose/pull/14117
* Fix(display): stop ttyWriter.Done from hanging after context cancel by @glours in https://github.com/docker/compose/pull/14119
* Fix(build): honor provenance/sbom false in per-service bake attest by @glours in https://github.com/docker/compose/pull/14112
* Fix(compose): reject unknown subcommands under bridge/transformations by @glours in https://github.com/docker/compose/pull/14143
* Fix(plugins): honor PATHEXT for provider lookup on Windows by @ndeloof in https://github.com/docker/compose/pull/14159
* Fix(watch): stop swallowing SetRecursive errors via nolint by @glours in https://github.com/docker/compose/pull/14165
* Fix(bridge): confirm before wiping non-empty convert output dir by @glours in https://github.com/docker/compose/pull/14174
* Fix(down): spare dangling images of orphaned services, like their tagged image by @htoyoda18 in https://github.com/docker/compose/pull/14154

###### 🔧  Internal
* CI: raise e2e go-test timeout to 20m by @ndeloof in https://github.com/docker/compose/pull/14072
* Lint: replace gocyclo with gocognit by @ndeloof in https://github.com/docker/compose/pull/14057
* Test(e2e): prepend provider bin dir to PATH in provider tests by @glours in https://github.com/docker/compose/pull/14079
* Refactor: dismantle the gocognit hotspots, one concern per function by @ndeloof in https://github.com/docker/compose/pull/14060
* Test(e2e): declarative Scenario layer, project files under testdata/<TestName>/ by @ndeloof in https://github.com/docker/compose/pull/14087
* Docs: document engine container event sequences in up monitor by @ndeloof in https://github.com/docker/compose/pull/14024
* E2E: fix test resource isolation and make standalone parallelism configurable by @glours in https://github.com/docker/compose/pull/14073
* API: ScaleOptions carries the replica counts by @ndeloof in https://github.com/docker/compose/pull/14077
* Chore: explicit, unique, greppable internal names by @ndeloof in https://github.com/docker/compose/pull/14049
* Docs: update CONTRIBUTING.md to reflect current tooling and practices by @glours in https://github.com/docker/compose/pull/14098
* API: option structs document what the implementation actually honors by @ndeloof in https://github.com/docker/compose/pull/14078
* Test: unit-lock the

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