# Docker Compose v5.5.0

- Product: Docker Compose (https://whatsnew.fyi/product/docker-compose)
- Vendor: Docker
- Date: 2026-08-17
- Version: v5.5.0
- Original notes: https://github.com/docker/compose/releases/tag/v5.5.0
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.5.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'.

---

- **changed** — Overhaul image digest reconciliation to prevent unnecessary container recreation
- **changed** — compose pull now honors pull_policy refresh windows (daily, weekly, every_N)
- **fixed** — Skip pulling default image references for build-only services
- **fixed** — Stop pruning every dangling image of the project during watch
- **fixed** — Resolve service environment when computing --hash in config
- **fixed** — Skip unreadable directories instead of failing the watch
- **fixed** — Ignore one-off container events in up monitor
- **fixed** — Validate arguments of bridge subcommands
- **fixed** — Tolerate containers whose image record is gone

##### What's Changed

> ℹ️  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.                                                                                                      
>                                                                                                                                                                                                                                                        
> `compose pull` now honors `pull_policy` refresh windows (`daily`, `weekly`, `every_N`).

###### ✨ Improvements
* New image digest reconciliation process by @glours & @ndeloof https://github.com/docker/compose/pull/14011 https://github.com/docker/compose/pull/14041

###### 🐛 Fixes
* Fix(bridge): skip pulling default image references for build-only ser… by @ericwyles in https://github.com/docker/compose/pull/14010
* Fix(watch): stop pruning every dangling image of the project by @glours in https://github.com/docker/compose/pull/14012
* Fix(config): resolve service environment when computing --hash by @glours in https://github.com/docker/compose/pull/14002
* Fix(watch): skip unreadable directories instead of failing the watch by @Endika in https://github.com/docker/compose/pull/13992
* Fix: ignore one-off container events in up monitor by @brano-osif in https://github.com/docker/compose/pull/14038
* Fix(bridge): validate arguments of bridge subcommands by @glours in https://github.com/docker/compose/pull/14003
* Fix(images): tolerate containers whose image record is gone by @ndeloof in https://github.com/docker/compose/pull/14028

###### 🔧  Internal
* Test: Set stop_signal to SIGTERM in nginx-based services by @ricardobranco777 in https://github.com/docker/compose/pull/13881
* Chore: inline needlessly extracted single-use helpers by @ndeloof in https://github.com/docker/compose/pull/14048
* Add ENGINE column driven by label by @nicksieger in https://github.com/docker/compose/pull/13959

###### ⚙️ Dependencies
* Build(deps): bump github.com/moby/moby/client from 0.5.0 to 0.5.1 by @dependabot[bot] in https://github.com/docker/compose/pull/13999
* Build(deps): bump github/codeql-action/upload-sarif from 4.37.3 to 4.37.4 by @dependabot[bot] in https://github.com/docker/compose/pull/14009
* Build(deps): bump github/codeql-action/upload-sarif from 4.37.4 to 4.37.5 by @dependabot[bot] in https://github.com/docker/compose/pull/14019
* Build(deps): bump github.com/moby/buildkit from 0.32.1 to 0.32.2 by @dependabot[bot] in https://github.com/docker/compose/pull/14033
* Build(deps): bump github.com/docker/buildx from 0.36.0 to 0.36.1 by @dependabot[bot] in https://github.com/docker/compose/pull/14034
* Build(deps): bump docker/github-builder/.github/workflows/bake.yml from 1.15.0 to 1.16.0 in the docker-actions group by @dependabot[bot] in https://github.com/docker/compose/pull/14035
* Build(deps): bump github.com/moby/go-archive from 0.3.2 to 0.3.3 by @dependabot[bot] in https://github.com/docker/compose/pull/14043
* Build(deps): bump github/codeql-action/upload-sarif from 4.37.5 to 4.37.6 by @dependabot[bot] in https://github.com/docker/compose/pull/14022
* Build(deps): bump github.com/docker/cli from 29.6.2+incompatible to 29.7.2+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/14042
* Build(deps): bump google.golang.org/grpc from 1.82.1 to 1.83.0 by @dependabot[bot] in https://github.com/docker/compose/pull/14008
* Bump golang to version 1.26.6 by @glours in https://github.com/docker/compose/pull/14045


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

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