---
title: Docker Compose release notes
linkTitle: Release notes
weight: 10
description: Learn about the new features, bug fixes, and breaking changes for the newest Docker Compose release
keywords: release notes, compose
tags: [Release notes]
toc_max: 2
aliases:
- /release-notes/docker-compose/
- /compose/release-notes/
---

For more detailed information, see the [release notes in the Compose repo](https://github.com/docker/compose/releases/).

## 2.37.0

{{< release-date date="2025-06-05" >}}

### Bug fixes and enhancements

- Fixed an issue with random port allocation
- Fixed an issue recreating containers when not needed during inner loop
- Fixed a problem during `up --build` with `additional_context`

### Update

- Dependencies upgrade: bump compose-go to v2.6.4
- Dependencies upgrade: bump buildx to v0.24.0
- Dependencies upgrade: bump buildkit to v0.22.0

## 2.36.2

{{< release-date date="2025-05-23" >}}

### Bug fixes and enhancements

- Compose Bridge features are now part of Compose
- Improved display of the `docker compose images` command
- Promoted `bake` as the default build tool for Compose
- Fixed issues around build flow
- Fixed the restart of dependent services after `watch` rebuild images

### Update

- Dependencies upgrade: bump docker engine and cli to v28.2.2

## 2.36.1

{{< release-date date="2025-05-19" >}}

### Bug fixes and enhancements

- Introduced support of arrays for `provider` service `options` attribute
- Added `debug` messages in the extension protocol
- Fixed an issue when trying to publish a Compose application with a `provider` service
- Fixed build issues on Compose applications with `service.provider`
- Introduced `--lock-image-digests` to `config` command

### Update

- Dependencies upgrade: bump compose-go to v2.6.3
- Dependencies upgrade: bump containerd to 2.1.0

## 2.36.0

{{< release-date date="2025-05-07" >}}

### Bug fixes and enhancements

- Introduced `networks.interface_name`
- Added support for `COMPOSE_PROGRESS` env variable
- Added `service.provider` to external binaries
- Introduced build `--check` flag
- Fixed multiple panic issues when parsing Compose files

### Update

- Dependencies upgrade: bump compose-go to v2.6.2
- Dependencies upgrade: bump docker engine and cli to v28.1.0
- Dependencies upgrade: bump containerd to 2.0.5
- Dependencies upgrade: bump buildkit to v0.21.1

## 2.35.1

{{< release-date date="2025-04-17" >}}

### Bug fixes and enhancements

- Fixed an issue with bind mounts

### Update

- Dependencies upgrade: bump compose-go to v2.6.0
- Dependencies upgrade: bump docker engine and cli to v28.0.4
- Dependencies upgrade: bump buildx to v0.22.0

## 2.35.0

{{< release-date date="2025-04-10" >}}

### Bug fixes and enhancements

- Added support for [Docker Model Runner](/manuals/ai/model-runner.md) to easily integrate AI models into your Compose applications
- Added `build --print` command to help debug complex build configurations by showing the equivalent bake file
- Added `volume.type=image` to provide more flexible volume management for container images
- Added `--quiet` options to the `run` command for cleaner output when running containers
- Added `config --no-env-resolution` option to view raw configuration without environment variable substitution
- Fixed behavior of `depends_on` to prevent unnecessary container recreation when dependencies change
- Fixed support for secrets defined by environment variables when using `include`
- Fixed volume mount handling to ensure bind mounts work correctly in all scenarios

### Update

- Dependencies upgrade: bump docker engine and cli to v28.1.0
- Dependencies upgrade: bump buildx to v0.23.0
- Dependencies upgrade: bump buildkit to v0.21.0

## 2.34.0

{{< release-date date="2025-03-14" >}}

### Bug fixes and enhancements

- Added support of refresh `pull_policy` values `daily`, `weekly` and `every_<duration>`
- Introduced `include` attribut to `watch` definition to match file patterns
- Introduced `--env-from-file` in flag for the `docker compose run` command