Docker/Docker Compose

Docker Compose

Sun

Mon

Tue

Wed

Thu

Fri

Sat

JunJulAugSepOctNovDecJanFebMarAprMay

Less

Releases5Avg2/moVersionsv5.1.0v5.1.4

Highlights All Releases

Show prereleases

May 20, 2026

v5.1.4

↗

OCI artifact pulls route through Desktop proxy; publish flag fixed

What's Changed

✨ 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/compose/pull/13770
fix: restore stoppingEvent/stoppedEvent helpers for plugin stop hook by @glours in https://github.com/docker/compose/pull/13794
fix(publish): flag literal inline environment values by @glours in https://github.com/docker/compose/pull/13760

🔧 Internal

ci: remove unused e2e job from merge workflow by @glours in https://github.com/docker/compose/pull/13740
chore: update cagent-action to v1.4.4 by @derekmisler in https://github.com/docker/compose/pull/13745
Change verb tense in Docker Compose reference documentation by @ryanjbonnell in https://github.com/docker/compose/pull/13773
pkg/compose: go fix by @thaJeztah in https://github.com/docker/compose/pull/13782
refactor: code deduplication and simplification by @ndeloof in https://github.com/docker/compose/pull/13759
fix: make e2e tests pass reliably locally with Docker Desktop by @glours in https://github.com/docker/compose/pull/13741
refactor: drop Desktop beta-settings check; gate hint on LogsTab flag by @glours in https://github.com/docker/compose/pull/13755

⚙️ Dependencies

build(deps): bump github.com/mattn/go-shellwords from 1.0.12 to 1.0.13 by @dependabot[bot] in https://github.com/docker/compose/pull/13731
build(deps): bump github.com/docker/cli from 29.4.0+incompatible to 29.4.2+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13768
build(deps): bump github.com/moby/moby/client from 0.4.0 to 0.4.1 by @dependabot[bot] in https://github.com/docker/compose/pull/13752
build(deps): bump github.com/docker/cli from 29.4.2+incompatible to 29.4.3+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13776
build(deps): bump google.golang.org/grpc from 1.80.0 to 1.81.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13775
build(deps): update to go 1.26.3 by @thaJeztah in https://github.com/docker/compose/pull/13783
build(deps): bump google.golang.org/grpc from 1.81.0 to 1.81.1 by @dependabot[bot] in https://github.com/docker/compose/pull/13791
build(deps): bump github.com/compose-spec/compose-go/v2 from 2.10.2 to 2.11.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13798
build(deps): bump github.com/docker/cli from 29.4.3+incompatible to 29.5.1+incompatible by @dependabot[bot] in https://github.com/docker/compose/pull/13796
build(deps): bump golang.org/x/sys from 0.42.0 to 0.44.0 by @dependabot[bot] in https://github.com/docker/compose/pull/13788

New Contributors

@ryanjbonnell made their first contribution in https://github.com/docker/compose/pull/13773

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

Apr 15, 2026

v5.1.3

↗

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

v5.1.2

↗

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

v5.1.1

↗

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

v5.1.0

↗

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

Jan 21, 2026

v5.0.2

↗

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

v5.0.1

↗

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

↗

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

Oct 30, 2025

v2.40.3

↗

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

v2.40.2

↗

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

v2.40.1

↗

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

v2.40.0

↗

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

v2.39.4

↗

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

v2.39.3

↗

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

v2.39.2

↗

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

v2.39.1

↗

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

v2.39.0

↗

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

v2.38.2

↗

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

New Contributors

@mountdisk made their first contribution in https://github.com/docker/compose/pull/12991

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

Jun 30, 2025

v2.38.1

↗

What's Changed

✨ Improvements

implement model_variable by @ndeloof in https://github.com/docker/compose/pull/13001

⚙️ Dependencies

bump compose-go to version v2.7.1 by @glours in https://github.com/docker/compose/pull/13000

Full Changelog: https://github.com/docker/compose/compare/v2.38.0...v2.38.1

v2.38.0

↗

What's Changed

✨ Improvements

introduce support for models by @ndeloof in https://github.com/docker/compose/pull/12976
Add volumes command by @leoperegrino in https://github.com/docker/compose/pull/12954
remove publish limitation on bind mount by @glours in https://github.com/docker/compose/pull/12997
mount /var/run/docker.sock for --use-api-socket by @ndeloof in https://github.com/docker/compose/pull/12995

🐛 Fixes

only expose API socket to service asking for it by @ndeloof in https://github.com/docker/compose/pull/12972
check progress default value instead of empty string to use BUILDKIT_PROGRESS env variable value by @glours in https://github.com/docker/compose/pull/12982
exclude provider services from the list of dependencies that Compose should wait for by @glours in https://github.com/docker/compose/pull/12983
don't fail down cmd if services with pre_stop hook already stopped/removed by @glours in https://github.com/docker/compose/pull/12986
Swap to Reader in bake to avoid hangs on output by @nscott in https://github.com/docker/compose/pull/12984
make sure the post_start hooks fails by @glours in https://github.com/docker/compose/pull/12996
remove error message from exec outpout by default by @glours in https://github.com/docker/compose/pull/12992
fix: typos by @hezhizhen in https://github.com/docker/compose/pull/12963
pass project.environment to bake by @ndeloof in https://github.com/docker/compose/pull/12994
fix provider concurrent environment map accesses by @glours in https://github.com/docker/compose/pull/12999
e2e compose run --env by @ndeloof in https://github.com/docker/compose/pull/12967

⚙️ Dependencies

build(deps): bump github.com/docker/cli from 28.2.2+incompatible to 28.3.0+incompatible by @dependabot in https://github.com/docker/compose/pull/12974
build(deps): bump github.com/docker/docker from 28.2.2+incompatible to 28.3.0+incompatible by @dependabot in https://github.com/docker/compose/pull/12975

New Contributors

@nscott made their first contribution in https://github.com/docker/compose/pull/12984
@hezhizhen made their first contribution in https://github.com/docker/compose/pull/12963
@leoperegrino made their first contribution in https://github.com/docker/compose/pull/12954

Full Changelog: https://github.com/docker/compose/compare/v2.37.3...v2.38.0

More from Docker

Last Checked

3h ago

Latest

v5.1.4

Source

@docker/compose

Tracking since Aug 31, 2017

.json·.md·.atom