Docker/Docker Compose

Docker Compose

$npx -y @buildinternet/releases show docker-compose

Sun

Mon

Tue

Wed

Thu

Fri

Sat

AprMayJunJulAugSepOctNovDecJanFebMarApr

Less

Releases5Avg2/moVersionsv5.0.2 → v5.1.3

Apr 15, 2026

What's Changed

🐛 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/compose/pull/13721
Build and push Docker Desktop module image on release by @glours in https://github.com/docker/compose/pull/13726
Fix typo in SECURITY.md by @glours in https://github.com/docker/compose/pull/13730
Make hook hint deep links clickable using OSC 8 terminal hyperlinks by @glours in https://github.com/docker/compose/pull/13734
Remove 'provenance' attribute' by @glours in https://github.com/docker/compose/pull/13738

⚙️ Dependencies

build(deps): bump github.com/containerd/containerd/v2 from 2.2.2 to 2.2.3 by @dependabot[bot] in https://github.com/docker/compose/pull/13737

Full Changelog: https://github.com/docker/compose/compare/v5.1.2...v5.1.3

Apr 9, 2026

What's Changed

🐛 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 when resolving Dockerfile path by @ssam18 in https://github.com/docker/compose/pull/13669
Initialize and pass envFiles map in processExtends by @Mohamed-Moumni in https://github.com/docker/compose/pull/13678
Fix TestRunHook_ConsoleSize on macOS by @thaJeztah in https://github.com/docker/compose/pull/13686
Restore post-connect fallback for multi-network stacks on API < 1.44 by @jotka in https://github.com/docker/compose/pull/13629
Publish: return api.ErrCanceled when user declines interactive prompts by @ishwar170695 in https://github.com/docker/compose/pull/13674
Return error on non-ErrNotExist stat failures in Tar.Sync() by @Lidang-Jiang in https://github.com/docker/compose/pull/13684

🔧 Internal

Refactor: thread context through publish sensitive data check by @ishwar170695 in https://github.com/docker/compose/pull/13653
Add AI-powered PR review workflow via docker/cagent-action by @glours in https://github.com/docker/compose/pull/13659
Update cagent-action to latest (with better permissions) by @derekmisler in https://github.com/docker/compose/pull/13665
Pin GitHub Actions to commit SHA, remove pr-review workflow by @glours in https://github.com/docker/compose/pull/13662
Exclude hook_test.go from Windows builds and propagate ExecStart error in runWaitExec by @pawannn in https://github.com/docker/compose/pull/13683
Skip PR review workflow for Dependabot PRs by @glours in https://github.com/docker/compose/pull/13679
Use negotiated API version for network setup by @glours in https://github.com/docker/compose/pull/13690
Fix mixed assertion libraries in tests by @thaJeztah in https://github.com/docker/compose/pull/13689
Test: use random host port for dind TLS build test by @ricardobranco777 in https://github.com/docker/compose/pull/13630
Remove direct dependency on docker/docker by @glours in https://github.com/docker/compose/pull/13706

⚙️ Dependencies

Bump github.com/containerd/platforms from 1.0.0-rc.2 to 1.0.0-rc.3 by @dependabot[bot] in https://github.com/docker/compose/pull/13657
Bump golangci-lint to v2.11.3 and configure CLAUDE to use it on change by @ndeloof in https://github.com/docker/compose/pull/13656
Bump google.golang.org/grpc from 1.78.0 to 1.79.3 by @dependabot[bot] in https://github.com/docker/compose/pull/13642
Bump github.com/moby/patternmatcher from 0.6.0 to 0.6.1 by @dependabot[bot] in https://github.com/docker/compose/pull/13667
Bump go.opentelemetry.io/otel/sdk from 1.39.0 to 1.42.0 by @glours in https://github.com/docker/compose/pull/13663
Bump github.com/docker/cli from 29.2.1+incompatible to 29.3.1+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13670
Bump github.com/hashicorp/go-version from 1.8.0 to 1.9.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13692
Bump github.com/docker/buildx v0.33.0, buildkit v0.29.0 by @thaJeztah in https://github.com/docker/compose/pull/13693
Bump google.golang.org/grpc from 1.79.3 to 1.80.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13697
Bump github.com/containerd/platforms from 1.0.0-rc.3 to 1.0.0-rc.4 by @dependabot[bot] in https://github.com/docker/compose/pull/13696
Bump github.com/moby/moby/client v0.4.0, moby/api v1.54.1 by @thaJeztah in https://github.com/docker/compose/pull/13708
Bump github.com/docker/cli v29.4.0 by @thaJeztah in https://github.com/docker/compose/pull/13707
Bump compose-go to version v2.10.2 by @glours in https://github.com/docker/compose/pull/13705
Bump to Go 1.25.9 by @thaJeztah in https://github.com/docker/compose/pull/13720

New Contributors

@MaybeSam05 made their first contribution in https://github.com/docker/compose/pull/13634
@ishwar170695 made their first contribution in https://github.com/docker/compose/pull/13653
@derekmisler made their first contribution in https://github.com/docker/compose/pull/13665
@false200 made their first contribution in https://github.com/docker/compose/pull/13664
@ssam18 made their first contribution in https://github.com/docker/compose/pull/13669
@Mohamed-Moumni made their first contribution in https://github.com/docker/compose/pull/13678
@pawannn made their first contribution in https://github.com/docker/compose/pull/13683
@jotka made their first contribution in https://github.com/docker/compose/pull/13629
@Lidang-Jiang made their first contribution in https://github.com/docker/compose/pull/13684

Full Changelog: https://github.com/docker/compose/compare/v5.1.1...v5.1.2

Mar 20, 2026

What's Changed

🐛 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

update to go1.25.8 by @thaJeztah in https://github.com/docker/compose/pull/13622
bump github.com/moby/moby/api from 1.53.0 to 1.54.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13619
bump golang.org/x/sys from 0.41.0 to 0.42.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13626
bump github.com/containerd/containerd/v2 from 2.2.1 to 2.2.2 by @dependabot[bot] in https://github.com/docker/compose/pull/13631
bump golang.org/x/sync from 0.19.0 to 0.20.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13627
bump github.com/moby/moby/client from 0.2.2 to 0.3.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13621

New Contributors

@maks2134 made their first contribution in https://github.com/docker/compose/pull/13640

Full Changelog: https://github.com/docker/compose/compare/v5.1.0...v5.1.1

Feb 24, 2026

What's Changed

🐛 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 https://github.com/docker/compose/pull/13551
compose: recreate container when mounted image digest changes by @ibrahimypr in https://github.com/docker/compose/pull/13549
fix panic by @ndeloof in https://github.com/docker/compose/pull/13562
Fix invalid path error when using OCI artifacts on Windows by @mikesir87 in https://github.com/docker/compose/pull/13574
fix: execute post_start hooks in docker compose run by @veeceey in https://github.com/docker/compose/pull/13607
Fix panic when watch rebuilds without up by @maxproske in https://github.com/docker/compose/pull/13610

🔧 Internal

fsnotify is set in Dockerfile by @ndeloof in https://github.com/docker/compose/pull/13533
Dockerfile: update golangci-lint to v2.8.0 by @thaJeztah in https://github.com/docker/compose/pull/13535
replace some uses of strings.Split(N) for strings.Cut by @thaJeztah in https://github.com/docker/compose/pull/13542
Upgrade GitHub Actions to latest versions by @salmanmkc in https://github.com/docker/compose/pull/13546
pkg/compose: remove dependency on github.com/docker/buildx/driver by @thaJeztah in https://github.com/docker/compose/pull/13563
use Docker GitHub Builder to build and sign binaries and bin image by @crazy-max in https://github.com/docker/compose/pull/13568
ci: fix bin-image job by @crazy-max in https://github.com/docker/compose/pull/13569
pkg/compose: defaultNetworkSettings: refactor by @thaJeztah in https://github.com/docker/compose/pull/13580
pkg/compose: un-export consts by @thaJeztah in https://github.com/docker/compose/pull/13584
modernize some code by @thaJeztah in https://github.com/docker/compose/pull/13588

⚙️ Dependencies

update to go1.25.7 by @thaJeztah in https://github.com/docker/compose/pull/13573
build(deps): bump golang.org/x/sys from 0.40.0 to 0.41.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13578
build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.3 to 4.0.0-rc.4 by @dependabot[bot] in https://github.com/docker/compose/pull/13541
migrate to moby modules by @thaJeztah in https://github.com/docker/compose/pull/13078

New Contributors

@MaheshThakur9152 made their first contribution in https://github.com/docker/compose/pull/13529
@salmanmkc made their first contribution in https://github.com/docker/compose/pull/13546
@Nepomuk5665 made their first contribution in https://github.com/docker/compose/pull/13551
@ibrahimypr made their first contribution in https://github.com/docker/compose/pull/13549
@veeceey made their first contribution in https://github.com/docker/compose/pull/13607

Full Changelog: https://github.com/docker/compose/compare/v5.0.2...v5.1.0

Jan 21, 2026

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

Dec 18, 2025

What's Changed

🐛 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 run --quiet. by @ndeloof in https://github.com/docker/compose/pull/13430
Fixed SDK example by @ndeloof in https://github.com/docker/compose/pull/13416
Added a check buildx version is set before comparing it. by @yangfeiyu20102011 in https://github.com/docker/compose/pull/13415
Fixed grammar: pluralize 'service' and remove apostrophes in lets. by @rashmivagha in https://github.com/docker/compose/pull/13423
Fixed progress UI not restoring terminal once operation completes. by @ndeloof in https://github.com/docker/compose/pull/13439
Fixed status alignment in progress UI. by @ndeloof in https://github.com/docker/compose/pull/13438
Restored image layer download progress details on pull. by @ndeloof in https://github.com/docker/compose/pull/13445
Added 'configured' event at the end of model configuration phase. by @glours in https://github.com/docker/compose/pull/13446
Introduced a build tag to select watcher implementation. by @ndeloof in https://github.com/docker/compose/pull/13452
Removed mention for v2 on README. by @alexislefebvre in https://github.com/docker/compose/pull/13451
Fixed missing error handling in setEnvWithDotEnv. by @htoyoda18 in https://github.com/docker/compose/pull/13450
Adopted morikuni/aec library over raw ANSI sequences. by @ndeloof in https://github.com/docker/compose/pull/13440
Prevented incorrect progress metrics to break compose display. by @ndeloof in https://github.com/docker/compose/pull/13457
Restored support for BUILDKIT_PROGRESS. by @ndeloof in https://github.com/docker/compose/pull/13455
Added check model plugin is successfully loaded. by @ndeloof in https://github.com/docker/compose/pull/13464
Added a warning when no service has been selected to build. by @ndeloof in https://github.com/docker/compose/pull/13467

⚙️ Dependencies

Drop Go min patch version by @austinvazquez in https://github.com/docker/compose/pull/13418
bump golang 1.24.11 by @austinvazquez in https://github.com/docker/compose/pull/13417
bump osxcross by @ndeloof in https://github.com/docker/compose/pull/13425
bump golang.org/x/sys from 0.38.0 to 0.39.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13433
bump github.com/docker/cli-docs-tool from 0.10.0 to 0.11.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13437
bump golang.org/x/sync from 0.18.0 to 0.19.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13434
bump tags.cncf.io/container-device-interface from 1.0.1 to 1.1.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13441
bump github.com/moby/buildkit from 0.26.2 to 0.26.3 by @dependabot[bot] in https://github.com/docker/compose/pull/13462

New Contributors

@yangfeiyu20102011 made their first contribution in https://github.com/docker/compose/pull/13415
@xiaolinny made their first contribution in https://github.com/docker/compose/pull/13429
@alexislefebvre made their first contribution in https://github.com/docker/compose/pull/13451
@htoyoda18 made their first contribution in https://github.com/docker/compose/pull/13450

Full Changelog: https://github.com/docker/compose/compare/v5.0.0...v5.0.1

Dec 2, 2025

v5.0.0 "Mont Blanc"

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 to skip 3.0.0 for next major release after docker Compose v2 to prevent (more) confusion with the obsolete docker-compose file versions 2.x and 3.x inherited from Docker Compose v1. We also skipped 4.0.0 to have a clear separation with this legacy.

What's Changed

✨ Improvements

drop support for internal buildkit builder by @ndeloof in https://github.com/docker/compose/pull/13056
Setup Compose service using functional parameters by @ndeloof in https://github.com/docker/compose/pull/13312
Introduce abstractions to support SDK usage without requiring Docker CLI by @glours in https://github.com/docker/compose/pull/13313
configure Compose service with io.Reader and io.Writer by @glours in https://github.com/docker/compose/pull/13322
Make progress Writer a CLI component by @ndeloof in https://github.com/docker/compose/pull/13316
SDK docs by @ndeloof in https://github.com/docker/compose/pull/13350
document support for OCI and Git remote resources by @ndeloof in https://github.com/docker/compose/pull/13362
run hooks on restart by @ndeloof in https://github.com/docker/compose/pull/13321
fix(run): Ensure images exist only for the target service in run command by @idsulik in https://github.com/docker/compose/pull/13325
Add load project to api definition by @glours in https://github.com/docker/compose/pull/13329
introduce --insecure-registry, reserved for testing purpose by @ndeloof in https://github.com/docker/compose/pull/13355
Move progress package to cmd as a command line component by @ndeloof in https://github.com/docker/compose/pull/13357
Added support for build.no_cache_filter by @ndeloof in https://github.com/docker/compose/pull/13377
add --wait option to start command by @ndeloof in https://github.com/docker/compose/pull/13409

🐛 Fixes

fix OCI compose override support by @ndeloof in https://github.com/docker/compose/pull/13311
Fix help output for "exec --no-tty" option by @tonyo in https://github.com/docker/compose/pull/13314
fix typo in error message by @stasadev in https://github.com/docker/compose/pull/13328
disable progress UI when build is ran with --print by @ndeloof in https://github.com/docker/compose/pull/13351
add (restore) support for detach keys by @ndeloof in https://github.com/docker/compose/pull/13369
images command should display image Created time or N/A if not available by @ndeloof in https://github.com/docker/compose/pull/13376
Fix support for port range by @ndeloof in https://github.com/docker/compose/pull/13381
skip includes preparing publish by @ndeloof in https://github.com/docker/compose/pull/13400
feat(model): ignore runtime flags in model configuration by @ilopezluna in https://github.com/docker/compose/pull/13404

🔧 Internal

Next release will be major version v5.x by @ndeloof in https://github.com/docker/compose/pull/13375
Test to check writeComposeFile detects invalid OCI artifact by @ndeloof in https://github.com/docker/compose/pull/13309
Code Cleanup by @ndeloof in https://github.com/docker/compose/pull/13315
fix various linting issues by @thaJeztah in https://github.com/docker/compose/pull/13326
Making the American/British spellings consistent to the error messages by @JLesDev in https://github.com/docker/compose/pull/13366
gha: test against docker v29, v28, and rename checks to use stable, oldstable by @thaJeztah in https://github.com/docker/compose/pull/13380
refactor: replace Split in loops with more efficient SplitSeq by @vicerace in https://github.com/docker/compose/pull/13393
refactor: use strings.Builder to improve performance by @liuyueyangxmu in https://github.com/docker/compose/pull/13398
Fix grammar: change 'adopted' to 'adopt' in Docker Swarm note by @rashmivagha in https://github.com/docker/compose/pull/13407
golangci-lint: use gci formatter instead of goimports by @thaJeztah in https://github.com/docker/compose/pull/13406
refactor: replace interface{} with any for clarity and modernization by @zjumathcode in https://github.com/docker/compose/pull/13411

⚙️ Dependencies

Bump compose go to v2.10.0 by @ndeloof in https://github.com/docker/compose/pull/13410
build(deps): bump github.com/containerd/platforms from 1.0.0-rc.1 to 1.0.0-rc.2 by @dependabot[bot] in https://github.com/docker/compose/pull/13353
build(deps): bump github.com/docker/docker from 28.5.1+incompatible to 28.5.2+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13361
build(deps): bump github.com/containerd/containerd/v2 from 2.1.4 to 2.2.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13358
build(deps): bump github.com/docker/cli from 28.5.1+incompatible to 28.5.2+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13360
build(deps): bump golang.org/x/sys from 0.37.0 to 0.38.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13367
build(deps): bump golang.org/x/sync from 0.17.0 to 0.18.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13368
Dockerfile: update golangci-lint to v2.6.2 by @thaJeztah in https://github.com/docker/compose/pull/13370
build(deps): bump buildx v0.30.0, buildkit v0.26.0, otel v1.38.0, otel/contrib v0.63.0 by @thaJeztah in https://github.com/docker/compose/pull/13379
bump dependencies by @ndeloof in https://github.com/docker/compose/pull/13392
build(deps): bump github.com/hashicorp/go-version from 1.7.0 to 1.8.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13403
build(deps): bump golang.org/x/crypto v0.45.0 by @thaJeztah in https://github.com/docker/compose/pull/13405

New Contributors

@tonyo made their first contribution in https://github.com/docker/compose/pull/13314
@stasadev made their first contribution in https://github.com/docker/compose/pull/13328
@JLesDev made their first contribution in https://github.com/docker/compose/pull/13366
@vicerace made their first contribution in https://github.com/docker/compose/pull/13393
@liuyueyangxmu made their first contribution in https://github.com/docker/compose/pull/13398
@ilopezluna made their first contribution in https://github.com/docker/compose/pull/13404
@rashmivagha made their first contribution in https://github.com/docker/compose/pull/13407
@zjumathcode made their first contribution in https://github.com/docker/compose/pull/13411

Full Changelog: https://github.com/docker/compose/compare/v2.40.2...v5.0.0

Nov 13, 2025

What's Changed

Next release will be major version v5.x by @ndeloof in https://github.com/docker/compose/pull/13375
images command should display image Created time or N/A if not available by @ndeloof in https://github.com/docker/compose/pull/13376

Full Changelog: https://github.com/docker/compose/compare/v5.0.0-rc.1...v5.0.0-rc.2

Nov 12, 2025

What's Changed

This is the first (candidate) release for next major Docker Compose release. To avoid confusion with the "v2" and "v3" legacy compose file formats, we decided to directly jump to version 5.x

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)

✨ Improvements

Document use as a SDK by @ndeloof in https://github.com/docker/compose/pull/13350
Setup Compose service using functional parameters by @ndeloof in https://github.com/docker/compose/pull/13312
drop support for internal buildkit builder by @ndeloof in https://github.com/docker/compose/pull/13056
document support for OCI and Git remote resources by @ndeloof in https://github.com/docker/compose/pull/13362
introduce --insecure-registry, reserved for testing purpose by @ndeloof in https://github.com/docker/compose/pull/13355
add (restore) support for detach keys by @ndeloof in https://github.com/docker/compose/pull/13369

🐛 Fixes

fix(run): Ensure images exist only for the target service in run command by @idsulik in * fix typo in error message by @stasadev in https://github.com/docker/compose/pull/13328 https://github.com/docker/compose/pull/13325

🔧 Internal

fix various linting issues by @thaJeztah in https://github.com/docker/compose/pull/13326

⚙️ Dependencies

bump compose-go to version v2.9.1 by @glours in https://github.com/docker/compose/pull/13332
build(deps): bump github.com/containerd/platforms from 1.0.0-rc.1 to 1.0.0-rc.2 by @dependabot[bot] in https://github.com/docker/compose/pull/13353
build(deps): bump github.com/moby/buildkit from 0.25.1 to 0.25.2 by @dependabot[bot] in https://github.com/docker/compose/pull/13359
build(deps): bump github.com/docker/docker from 28.5.1+incompatible to 28.5.2+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13361
build(deps): bump github.com/containerd/containerd/v2 from 2.1.4 to 2.2.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13358
build(deps): bump github.com/docker/cli from 28.5.1+incompatible to 28.5.2+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13360
build(deps): bump golang.org/x/sys from 0.37.0 to 0.38.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13367
build(deps): bump golang.org/x/sync from 0.17.0 to 0.18.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13368

New Contributors

@tonyo made their first contribution in https://github.com/docker/compose/pull/13314
@stasadev made their first contribution in https://github.com/docker/compose/pull/13328
@JLesDev made their first contribution in https://github.com/docker/compose/pull/13366

Full Changelog: https://github.com/docker/compose/compare/v2.40.2...v5.0.0-rc.1

Oct 30, 2025

What's Changed

🐛 Fixes

Fix OCI compose override support by @ndeloof https://github.com/docker/compose/pull/13311
Fix help output for "exec --no-tty" option by @tonyo https://github.com/docker/compose/pull/13314
Prompt default implementation to prevent a panic by @ndeloof https://github.com/docker/compose/pull/13317
Run hooks on restart by @ndeloof https://github.com/docker/compose/pull/13321
Fix(run): Ensure images exist only for the target service in run command by @idsulik https://github.com/docker/compose/pull/13325
Fix(git): Fix path traversal vulnerability in git remote loader by @idsulik https://github.com/docker/compose/pull/13331

🔧 Internal

Test to check writeComposeFile detects invalid OCI artifact by @ndeloof https://github.com/docker/compose/pull/13309
Code Cleanup by @ndeloof https://github.com/docker/compose/pull/13315

⚙️ Dependencies

Bump compose-go to version v2.9.1 by @glours https://github.com/docker/compose/pull/13332

Full Changelog: https://github.com/docker/compose/compare/v2.40.2...v2.40.3

Oct 22, 2025

What's Changed

🐛 Fixes

Compose can't create a tar with adequate uid:gid ownership by @ndeloof in https://github.com/docker/compose/pull/13299
Test digest or canonical reference, not only tag, when checking if an image is already present by @glours in https://github.com/docker/compose/pull/13302

🔧 Internal

Fail build if minimal required version of buildx isn't installed by @ndeloof in https://github.com/docker/compose/pull/13295
remove unused code to only rely on api.Service by @ndeloof in https://github.com/docker/compose/pull/13300
Introduce WithPrompt to configure compose backend to use a plugable UI component for user interaction by @ndeloof in https://github.com/docker/compose/pull/13308

Full Changelog: https://github.com/docker/compose/compare/v2.40.1...v2.40.2

Oct 17, 2025

What's Changed

🐛 Fixes

Write error to watcher error channel if Start() fails by @Trolldemorted in https://github.com/docker/compose/pull/13263
Fix: set PWD only if not set by @kianelbo in https://github.com/docker/compose/pull/13268
bake only interpolates ${*} by @ndeloof in https://github.com/docker/compose/pull/13270
Fix: make "publish" push all compose files addressed in "extends" statements when using "profiles". by @ogoulpeau-ledger in https://github.com/docker/compose/pull/13277
Support Ctrl+Z to run compose in background by @ndeloof in https://github.com/docker/compose/pull/13289
Fix race-condition bug in publish command by @paul-kinexon in https://github.com/docker/compose/pull/13291
Set secret/config uid:gid to match container's USER by @ndeloof in https://github.com/docker/compose/pull/13288
Fix failure to delegate build with bake by @ndeloof in https://github.com/docker/compose/pull/13275
Make CTRL+Z a no-op operation on Windows by @glours in https://github.com/docker/compose/pull/13293

🔧 Internal

pkg/compose: align classic builder implementation with docker/cli by @thaJeztah in https://github.com/docker/compose/pull/13278
pkg/compose: build with bake: drop support for buildx v0.16 and lower by @thaJeztah in https://github.com/docker/compose/pull/13280
Use fixed version of compose bridge transformer images by @glours in https://github.com/docker/compose/pull/13284

⚙️ Dependencies

Build(deps): bump github.com/docker/docker from 28.5.0+incompatible to 28.5.1+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13274
Build(deps): bump github.com/docker/cli from 28.5.0+incompatible to 28.5.1+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13273
Build(deps): bump golang.org/x/sys from 0.36.0 to 0.37.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13272
Build(deps): bump docker/buildx v0.29.1, moby/buildkit v0.25.1 by @thaJeztah in https://github.com/docker/compose/pull/13279
Bump golang to version 1.24.9 by @glours in https://github.com/docker/compose/pull/13285

New Contributors

@Trolldemorted made their first contribution in https://github.com/docker/compose/pull/13263
@ogoulpeau-ledger made their first contribution in https://github.com/docker/compose/pull/13277
@paul-kinexon made their first contribution in https://github.com/docker/compose/pull/13291

Full Changelog: https://github.com/docker/compose/compare/v2.40.0...v2.40.1

Oct 3, 2025

What's Changed

✨ Improvements

publish Compose application as compose.yaml + images by @ndeloof in https://github.com/docker/compose/pull/13257

🐛 Fixes

resolve secrets based on env var before executing bake by @ndeloof in https://github.com/docker/compose/pull/13237
pass bake secrets by env by @ndeloof in https://github.com/docker/compose/pull/13249
escape $ in bake.json as interpolation already has been managed by cpmpose by @ndeloof in https://github.com/docker/compose/pull/13259

🔧 Internal

pkg/compose: remove uses of deprecated mitchellh/mapstructure module by @thaJeztah in https://github.com/docker/compose/pull/13239
pkg/watch: remove unused IsWindowsShortReadError by @thaJeztah in https://github.com/docker/compose/pull/13052
pkg/compose: build: remove permissions warning on Windows by @thaJeztah in https://github.com/docker/compose/pull/13236
pluginMain: remove uses of DockerCLI.Apply by @thaJeztah in https://github.com/docker/compose/pull/13240
use containerd registry client by @ndeloof in https://github.com/docker/compose/pull/13245
provider services: use '--project-name=' notation by @glours in https://github.com/docker/compose/pull/13250
gha: update test-matrix: remove docker 26.x by @thaJeztah in https://github.com/docker/compose/pull/13254
pkg/compose: explicitly map AuthConfig fields instead of a direct cast by @thaJeztah in https://github.com/docker/compose/pull/13253
cmd/compose: fix minor linting issues by @thaJeztah in https://github.com/docker/compose/pull/13252
use containerd client for OCI operations by @ndeloof in https://github.com/docker/compose/pull/13251

⚙️ Dependencies

build(deps): bump github.com/docker/docker, docker/cli v28.5.0-rc.1 by @thaJeztah in https://github.com/docker/compose/pull/13241
build(deps): bump github.com/docker/docker from 28.5.0-rc.1+incompatible to 28.5.0+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13260
build(deps): bump github.com/docker/cli from 28.5.0-rc.1+incompatible to 28.5.0+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13261

Full Changelog: https://github.com/docker/compose/compare/v2.39.4...v2.40.0

Sep 19, 2025

What's Changed

✨ Improvements

Add support of develop.watch.initial_sync attribute by @glours in https://github.com/docker/compose/pull/13232

🐛 Fixes

Volume ls command can run without a project by @ndeloof in https://github.com/docker/compose/pull/13221
Fix support for build with bake when target docker endpoint requires TLS by @ndeloof in https://github.com/docker/compose/pull/13231
Disable Tty if run command started from a piped command by @glours in https://github.com/docker/compose/pull/13233

🔧 Internal

Test: Set stop_signal to SIGTERM by @ricardobranco777 in https://github.com/docker/compose/pull/13214

⚙️ Dependencies

Bump compose-go to version v2.9.0 by @glours in https://github.com/docker/compose/pull/13234

New Contributors

@ricardobranco777 made their first contribution in https://github.com/docker/compose/pull/13214

Full Changelog: https://github.com/docker/compose/compare/v2.39.3...v2.39.4

Sep 9, 2025

What's Changed

✨ Improvements

Add completions for the --progress flag by @m4rch3n1ng in https://github.com/docker/compose/pull/13158

🐛 Fixes

Add --provenance and --sbom flag to generated bake command line, by @glours in https://github.com/docker/compose/pull/13147
Fix runtime operations failing when env file is missing by @maxproske in https://github.com/docker/compose/pull/13156
Check the assume yes publish flag command before the presence of bind mounts by @glours in https://github.com/docker/compose/pull/13151
Fix: incorrect time when last tag time is not set by @kianelbo in https://github.com/docker/compose/pull/13171
Fix sigint/sigterm support in logs --follow by @ndeloof in https://github.com/docker/compose/pull/13193
Prefer application container vs one-off running exec without index by @ndeloof in https://github.com/docker/compose/pull/13178
Only force plain mode build if progress is set to auto by @ndeloof in https://github.com/docker/compose/pull/13181
Only propagate os.Env to bake, not the whole project.Environment by @ndeloof in https://github.com/docker/compose/pull/13180
Detect container is restarted by @ndeloof in https://github.com/docker/compose/pull/13210
Fix run --build support for service:* reference in additional_context by @ndeloof in https://github.com/docker/compose/pull/13183
Detect compose run wit --host and set DOCKER_HOST accordingly running bake by @ndeloof in https://github.com/docker/compose/pull/13182

🔧 Internal

Refactor to use maps.Copy by @cuiweixie in https://github.com/docker/compose/pull/13174
Replace most uses of hashicorp/go-multierror for stdlib by @thaJeztah in https://github.com/docker/compose/pull/13176
pkg/compose: composeService.Up: rewrite without go-multierror by @thaJeztah in https://github.com/docker/compose/pull/13177
Use enum-consts for State and Health by @thaJeztah in https://github.com/docker/compose/pull/13186
Unquote volume names in creation events by @rrjjvv in https://github.com/docker/compose/pull/13188
pkg/compose: use state consts from moby API by @thaJeztah in https://github.com/docker/compose/pull/13216
Document (hidden) --tty --interactive flags by @ndeloof in https://github.com/docker/compose/pull/13201

⚙️ Dependencies

go.mod: github.com/docker/buildx v0.27.0 by @thaJeztah in https://github.com/docker/compose/pull/13170
Build(deps): bump go.uber.org/mock from 0.5.2 to 0.6.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13162
go.mod: bump buildkit v0.24.0-rc1, buildx v0.28.0-rc1 by @thaJeztah in https://github.com/docker/compose/pull/13185
Build(deps): bump github.com/stretchr/testify from 1.10.0 to 1.11.1 by @dependabot[bot] in https://github.com/docker/compose/pull/13184
go.mod: bump buildx v0.28.0-rc2, buildkit v0.24.0-rc2 by @thaJeztah in https://github.com/docker/compose/pull/13197
Build(deps): bump github.com/spf13/pflag from 1.0.7 to 1.0.9 by @dependabot[bot] in https://github.com/docker/compose/pull/13195
Build(deps): bump github.com/spf13/cobra from 1.9.1 to 1.10.1 by @dependabot[bot] in https://github.com/docker/compose/pull/13198
go.mod: bump github.com/docker/docker, docker/cli v28.4.0 by @thaJeztah in https://github.com/docker/compose/pull/13168
Build(deps): bump github.com/docker/buildx from 0.28.0-rc2 to 0.28.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13207
Build(deps): bump github.com/spf13/pflag from 1.0.9 to 1.0.10 by @dependabot[bot] in https://github.com/docker/compose/pull/13200
Bump golang to version 1.24.7 by @glours in https://github.com/docker/compose/pull/13219
Build(deps): bump golang.org/x/sync from 0.16.0 to 0.17.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13218
Build(deps): bump golang.org/x/sys from 0.35.0 to 0.36.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13217
Bump compose-go to version v2.8.2 by @glours in https://github.com/docker/compose/pull/13220

New Contributors

@cuiweixie made their first contribution in https://github.com/docker/compose/pull/13174
@m4rch3n1ng made their first contribution in https://github.com/docker/compose/pull/13158
@kianelbo made their first contribution in https://github.com/docker/compose/pull/13171
@rrjjvv made their first contribution in https://github.com/docker/compose/pull/13188

Full Changelog: https://github.com/docker/compose/compare/v2.39.2...v2.39.3

Aug 8, 2025

What's Changed

🐛 Fixes

Fix (regression): compose build render build output with tty support by @ndeloof in https://github.com/docker/compose/pull/13107
Add missing _MODEL suffix to model variable pass to dependent services of a model by @glours in https://github.com/docker/compose/pull/13109
Apply BUILDKIT_PROGRESS value when building with bake by @glours in https://github.com/docker/compose/pull/13110
Define pull and no_cache from either service or flags values when building with bake by @glours in https://github.com/docker/compose/pull/13133
Only monitor attached services on up command by @glours in https://github.com/docker/compose/pull/13114

🔧 Internal

Add Streams Comment by @suwakei in https://github.com/docker/compose/pull/13103
Add test of json.go by @suwakei in https://github.com/docker/compose/pull/13106
Refactoring of redundant condition checks by @suwakei in https://github.com/docker/compose/pull/13104
Eliminated magic string by @suwakei in https://github.com/docker/compose/pull/13105
Use log API for containers we didn't attached to by @ndeloof in https://github.com/docker/compose/pull/13111
Use cli-plugins/metadata package by @thaJeztah in https://github.com/docker/compose/pull/13130
pkg/compose: simplify getting auth-config key by @thaJeztah in https://github.com/docker/compose/pull/13120
Add go as a prerequisite in build instructions by @mattrunyon in https://github.com/docker/compose/pull/13131

⚙️ Dependencies

Build(deps): bump github.com/docker/cli from 28.3.2+incompatible to 28.3.3+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13116
Build(deps): bump github.com/docker/docker from 28.3.2+incompatible to 28.3.3+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13115
Build(deps): bump github.com/containerd/containerd/v2 from 2.1.3 to 2.1.4 by @dependabot[bot] in https://github.com/docker/compose/pull/13119
Build(deps): bump github.com/docker/go-connections from 0.5.0 to 0.6.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13137
Build(deps): bump golang.org/x/sys from 0.34.0 to 0.35.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13138
Bump golang to 1.23.12 by @austinvazquez in https://github.com/docker/compose/pull/13142

New Contributors

@mattrunyon made their first contribution in https://github.com/docker/compose/pull/13131
@austinvazquez made their first contribution in https://github.com/docker/compose/pull/13142

Full Changelog: https://github.com/docker/compose/compare/v2.39.1...v2.39.2

Jul 24, 2025

What's Changed

🔧 Internal

Add info about models usage to OpenTelemetry spans by @glours in https://github.com/docker/compose/pull/13094

⚙️ Dependencies

Bump compose-go to v2.8.1 by @glours in https://github.com/docker/compose/pull/13096

Full Changelog: https://github.com/docker/compose/compare/v2.39.0...v2.39.1

What's Changed

✨ Improvements

Add --since & --until flags to events command by @jarqvi in https://github.com/docker/compose/pull/13030
Feat(os): add FreeBSD support by @atagtm in https://github.com/docker/compose/pull/13036
Add --models flag to config command by @jarqvi in https://github.com/docker/compose/pull/13022
Warn user COMPOSE_BAKE=false is deprecated by @ndeloof in https://github.com/docker/compose/pull/13065
Simpler stop UI by @ndeloof in https://github.com/docker/compose/pull/13064
Introduce build provenance and sbom attributes support by @ndeloof in https://github.com/docker/compose/pull/13067
Show build progress during watch rebuild by @ndeloof in https://github.com/docker/compose/pull/13059

🐛 Fixes

Add dry-run support to bake build by @glours in https://github.com/docker/compose/pull/13042
Keep containers attached on stop to capture termination logs by @ndeloof in https://github.com/docker/compose/pull/13010
Add default compose labels to images built from bake by @glours in https://github.com/docker/compose/pull/13049
Fix report image name in bake result by @principis in https://github.com/docker/compose/pull/13047
Don't run navigation menu if stdin isn't a terminal by @ndeloof in https://github.com/docker/compose/pull/13054
Monitor must watch events even when context is cancelled by @ndeloof in https://github.com/docker/compose/pull/13062
Force plain display mode if stdout isn't a terminal by @ndeloof in https://github.com/docker/compose/pull/13074
Do not pass user id on Windows system as engine is not able to handel it by @glours in https://github.com/docker/compose/pull/13080
Forward git command error to user by @ndeloof in https://github.com/docker/compose/pull/13084
Use output registry when push true and load to docker store if not by @glours in https://github.com/docker/compose/pull/13085

🔧 Internal

Add a space character to separate the timestamp from the log message by @xduugu in https://github.com/docker/compose/pull/13038
Fix the Helm bridge e2e tests after the latest update of the templates by @glours in https://github.com/docker/compose/pull/13053
Introduce monitor to manage containers events and application termination by @ndeloof in https://github.com/docker/compose/pull/12906
Abstract model-cli commands execution with a model (pseudo) API by @ndeloof in https://github.com/docker/compose/pull/13051
Swarm by @ndeloof in https://github.com/docker/compose/pull/13071
Remove uses of moby/errdefs by @thaJeztah in https://github.com/docker/compose/pull/13076
Use local copy of pkg/system.IsAbs by @thaJeztah in https://github.com/docker/compose/pull/13075
Optimize ansiColorCode by replacing fmt.Sprintf with strings.Builder by @suwakei in https://github.com/docker/compose/pull/13091
Eliminate magic number in init functions by @suwakei in https://github.com/docker/compose/pull/13090
Integration of SetAttributes calls by @suwakei in https://github.com/docker/compose/pull/13089

⚙️ Dependencies

Bump engine and cli to v28.3.2 by @ndeloof in https://github.com/docker/compose/pull/13035
Build(deps): bump github.com/spf13/pflag from 1.0.6 to 1.0.7 by @dependabot[bot] in https://github.com/docker/compose/pull/13060
Bump compose-go to version v2.8.0 by @glours in https://github.com/docker/compose/pull/13082
Build(deps): bump google.golang.org/grpc from 1.73.0 to 1.74.2 by @dependabot[bot] in https://github.com/docker/compose/pull/13081
bump buildx to v0.26.1 by @glours in https://github.com/docker/compose/pull/13086

New Contributors

@atagtm made their first contribution in https://github.com/docker/compose/pull/13036
@xduugu made their first contribution in https://github.com/docker/compose/pull/13038
@principis made their first contribution in https://github.com/docker/compose/pull/13047
@suwakei made their first contribution in https://github.com/docker/compose/pull/13091

Full Changelog: https://github.com/docker/compose/compare/v2.38.2...v2.39.0

Jul 8, 2025

What's Changed

✨ Improvements

Add --networks flag to config command by @jarqvi in https://github.com/docker/compose/pull/13021

🐛 Fixes

Add a Done event to model progress display by @glours in https://github.com/docker/compose/pull/13008
Fix the way we're checking if the provider metadata are empty or not by @glours in https://github.com/docker/compose/pull/13017
Build: fix service with profile missing secrets by @ndeloof in https://github.com/docker/compose/pull/13023
Fix select dockerignore based on Dockerfile name set from symlink by @ndeloof in https://github.com/docker/compose/pull/13024

🔧 Internal

pkg/compose: remove redundant uses of strslice.StrSlice by @thaJeztah in https://github.com/docker/compose/pull/13002
(reactoring) avoid a global variable by introducing logConsumer decorator by @ndeloof in https://github.com/docker/compose/pull/12945
Chore: fix some minor issues in the comments by @mountdisk in https://github.com/docker/compose/pull/12991
A single place for shell-out command setup by @ndeloof in https://github.com/docker/compose/pull/13007
Add USER_AGENT variable to cmd when shellouting by @glours in https://github.com/docker/compose/pull/13025

⚙️ Dependencies

Bump golang to v1.23.10 by @glours in https://github.com/docker/compose/pull/13004
Bump go-viper/mapstructure to version v2.3.0 by @glours in https://github.com/docker/compose/pull/13005
Build(deps): bump github.com/moby/buildkit from 0.23.1 to 0.23.2 by @dependabot in https://github.com/docker/compose/pull/13009
Build(deps): bump github.com/docker/cli from 28.3.0+incompatible to 28.3.1+incompatible by @dependabot in https://github.com/docker/compose/pull/13012
Build(deps): bump github.com/docker/docker from 28.3.0+incompatible to 28.3.1+incompatible by @dependabot in https://github.com/docker/compose/pull/13011