ℹ️ 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.
Docker Compose 2 to 5
Every Docker Compose 5.x release the archive holds, 13 of them, starting at 5.0.0 and running to 5.5.0. The publisher writes these one at a time and its documentation describes the version you are on, so the run between two majors is not laid out anywhere as a list.
- Releases
- 1313 carry notes
- Opened
- 2 Dec 20259 months ago
- Span
- 9 monthsto 17 Aug 2026
- Breaking
- 0none tagged
The turn
Every 5.x release
All Docker Compose releasesℹ️ This release introduces a new way to reconcile resources such as volumes and networks ✨ Improvements Feat(reconcile): model volume recreation in the plan by @ndeloof in https://github.com/docker/compose/pull/13962 Feat(reconcile): model
🔧 Internal Ci: add concurrency group to pr-review-trigger to prevent duplicate reviews by @derekmisler in https://github.com/docker/compose/pull/13890 Fix grammar in Attestations field comment by @blackflytech in https://github.com/docker/
ℹ️ 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
ℹ️ 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 Reconciliati
✨ Improvements feat: add stop lifecycle hook for external providers by @glours in https://github.com/docker/compose/pull/13779 🐛 Fixes fix: route OCI artifact pulls through Docker Desktop HTTP proxy by @glours in https://github.com/docker/
🐛 Fixes fix: provider output handling and watch rebuild re-invocation by @glours in https://github.com/docker/compose/pull/13732 🔧 Internal Add Docker Desktop Logs view hints and navigation shortcut by @glours in https://github.com/docker
🐛 Fixes Fix TTY timer rendering when duration length changes by @MaybeSam05 in https://github.com/docker/compose/pull/13634 Fix up attach filtering by @false200 in https://github.com/docker/compose/pull/13664 Preserve ssh:// URL scheme whe
🐛 Fixes Only pass ConsoleSize to ExecAttach when TTY is enabled by @mikesir87 in https://github.com/docker/compose/pull/13616 Fix deadlock in ttyWriter.Done() by @maks2134 in https://github.com/docker/compose/pull/13640 ⚙️ Dependencies upd
🐛 Fixes emit container status events after network reconnection (fixes #13524) by @MaheshThakur9152 in https://github.com/docker/compose/pull/13529 Fix potential nil pointer dereference in container event monitoring by @Nepomuk5665 in http
🐛 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 Restore
🐛 Fixes Restored support for COMPOSE_COMPATIBILITY by @ndeloof in https://github.com/docker/compose/pull/13424 Fixed grammatical errors and improve clarity in code. by @xiaolinny in https://github.com/docker/compose/pull/13429 Fixed broken
Major changes in this release: Compose can now officially be used as a SDK to be integrated into third-party softwares Internal builder has been removed, build is delegated to Docker Bake (same as docker build command) Why "v5" ? We decided