# Docker Compose v5.3.0

- Product: Docker Compose (https://whatsnew.fyi/product/docker-compose)
- Vendor: Docker
- Date: 2026-07-02
- Version: v5.3.0
- Original notes: https://github.com/docker/compose/releases/tag/v5.3.0
- Permalink: https://whatsnew.fyi/product/docker-compose/releases/v5.3.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 native support for init containers
- **fixed** — Route authorizer token fetches through provided transport in OCI
- **fixed** — Scope Running events to project services
- **fixed** — Show private port in portNotFoundError message
- **fixed** — Normalize --no-TTY flag to --no-tty

##### What's Changed

> ℹ️ This release introduces native support for init containers.

###### ✨ Improvements
* Pre start init containers by @glours in https://github.com/docker/compose/pull/13862

###### 🐛 Fixes
* Fix(oci): route authorizer token fetches through provided transport by @glours in https://github.com/docker/compose/pull/13873
* Fix(run): scope Running events to project.Services by @glours in https://github.com/docker/compose/pull/13883

###### 🔧  Internal
* Chore: migrate cagent-action to docker-agent-action (v2.0.0) by @docker-agent in https://github.com/docker/compose/pull/13869
* Chore: migrate to docker-agent-action v2.0.1 by @docker-agent in https://github.com/docker/compose/pull/13872
* Fix(reconcile): hash resolved service refs to match executor by @glours in https://github.com/docker/compose/pull/13880
* Fix(compose/port): show private port in portNotFoundError message by @vmphase in https://github.com/docker/compose/pull/13875
* Fix(run): normalize --no-TTY flag to --no-tty by @nickjj in https://github.com/docker/compose/pull/13885

###### ⚙️ Dependencies
* Bump compose-go to version v2.13.0 by @glours in https://github.com/docker/compose/pull/13886





##### New Contributors
* @docker-agent made their first contribution in https://github.com/docker/compose/pull/13869
* @vmphase made their first contribution in https://github.com/docker/compose/pull/13875
* @nickjj made their first contribution in https://github.com/docker/compose/pull/13885

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