# Docker Compose v5.0.2

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

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

---

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