Docker Compose

Docker Inc.·Docker.DockerCompose

docker-compose plugin for docker cli

Define and run multi-container applications with Docker with simple configuration files and command: docker-compose up

winget install --id Docker.DockerCompose --exact --source winget

Latest 5.5.1·September 3, 2026

Release Notes

What's Changed

✨ Improvements

• Feat(hooks):capture and surface lifecycle hook output by @glours in https://github.com/docker/compose/pull/14091 • Feat(tracing):surface otel shutdown errors via --debug by @htoyoda18 in https://github.com/docker/compose/pull/14152

🐛 Fixes

• Fix(events):validate service names before subscribing to events by @glours in https://github.com/docker/compose/pull/14076 • Fix:bake target names collision for services differing by . vs _ by @ndeloof in https://github.com/docker/compose/pull/14058 • Fix(watch):sync into a symlinked directory instead of failing by @Endika in https://github.com/docker/compose/pull/14084 • Fix(hooks):include hook output in the error when a hook fails by @dennislapchenko in https://github.com/docker/compose/pull/14088 • Fix(build):TTY progress on Windows — hand the real stdout to buildkit by @ndeloof in https://github.com/docker/compose/pull/14090 • Fix(watch):sync all files on initial_sync, regardless of mtime by @glours in https://github.com/docker/compose/pull/14096 • Fix(network):pass IPAM options when creating networks by @glours in https://github.com/docker/compose/pull/14094 • Fix(ps):honor psFormat from Docker CLI config when no --format flag given by @glours in https://github.com/docker/compose/pull/14095 • Fix:dependency wait timeout surfaced only by luck by @ndeloof in https://github.com/docker/compose/pull/14105 • Fix:hold startMx on the start path actually exercised by @ndeloof in https://github.com/docker/compose/pull/14106 • Fix(watch):exclude Dockerfile and compose files from initial sync by @htoyoda18 in https://github.com/docker/compose/pull/14117 • Fix(display):stop ttyWriter.Done from hanging after context cancel by @glours in https://github.com/docker/compose/pull/14119 • Fix(build):honor provenance/sbom false in per-service bake attest by @glours in https://github.com/docker/compose/pull/14112 • Fix(compose):reject unknown subcommands under bridge/transformations by @glours in https://github.com/docker/compose/pull/14143 • Fix(plugins):honor PATHEXT for provider lookup on Windows by @ndeloof in https://github.com/docker/compose/pull/14159 • Fix(watch):stop swallowing SetRecursive errors via nolint by @glours in https://github.com/docker/compose/pull/14165 • Fix(bridge):confirm before wiping non-empty convert output dir by @glours in https://github.com/docker/compose/pull/14174 • Fix(down):spare dangling images of orphaned services, like their tagged image by @htoyoda18 in https://github.com/docker/compose/pull/14154

🔧 Internal

• CI:raise e2e go-test timeout to 20m by @ndeloof in https://github.com/docker/compose/pull/14072 • Lint:replace gocyclo with gocognit by @ndeloof in https://github.com/docker/compose/pull/14057 • Test(e2e):prepend provider bin dir to PATH in provider tests by @glours in https://github.com/docker/compose/pull/14079 • Refactor:dismantle the gocognit hotspots, one concern per function by @ndeloof in https://github.com/docker/compose/pull/14060 • Test(e2e):declarative Scenario layer, project files under testdata// by @ndeloof in https://github.com/docker/compose/pull/14087 • Docs:document engine container event sequences in up monitor by @ndeloof in https://github.com/docker/compose/pull/14024 • E2E:fix test resource isolation and make standalone parallelism configurable by @glours in https://github.com/docker/compose/pull/14073 • API:ScaleOptions carries the replica counts by @ndeloof in https://github.com/docker/compose/pull/14077 • Chore:explicit, unique, greppable internal names by @ndeloof in https://github.com/docker/compose/pull/14049 • Docs:update CONTRIBUTING.md to reflect current tooling and practices by @glours in https://github.com/docker/compose/pull/14098 • API:option structs document what the implementation actually honors by @ndeloof in https://github.com/docker/compose/pull/14078 • Test:unit-lock the imperative start path by @ndeloof in https://github.com/docker/compose/pull/14104 • CLI:display.Mode always resolves to the mode actually rendered by @ndeloof in https://github.com/docker/compose/pull/14103 • CI:validate generated mocks are in sync by @ndeloof in https://github.com/docker/compose/pull/14102 • Docs(sdk):document the EventProcessor API that actually exists by @ndeloof in https://github.com/docker/compose/pull/14131 • Test(e2e):gate the e2e suite behind the build tag the docs already promise by @ndeloof in https://github.com/docker/compose/pull/14132 • Build:error messages name the real remedy, not a removed builder by @ndeloof in https://github.com/docker/compose/pull/14133 • Docs(contributing):legibility guidelines — comments state behavior, not history by @ndeloof in https://github.com/docker/compose/pull/14135 • Test(docs):compile the sdk.md examples by @ndeloof in https://github.com/docker/compose/pull/14136 • Chore(compose):rename convergence.go, whose convergence engine no longer exists by @ndeloof in https://github.com/docker/compose/pull/14129 • Chore(compose):comments state behavior, not history by @ndeloof in https://github.com/docker/compose/pull/14130 • Test(build):re-enable wrong ssh key id test by @htoyoda18 in https://github.com/docker/compose/pull/14120 • Chore(compose):orphan semantics stated where up and down diverge by @ndeloof in https://github.com/docker/compose/pull/14142 • Refactor:NewGraph stops mutating the project by @ndeloof in https://github.com/docker/compose/pull/14124 • Test(e2e):bump compose-bridge images to v0.0.7 by @ricardobranco777 in https://github.com/docker/compose/pull/14170

⚙️ Dependencies

• Build(deps):bump github/codeql-action/upload-sarif from 4.37.6 to 4.37.7 by @dependabot[bot] in https://github.com/docker/compose/pull/14101 • Remove buildx as a Go dependency by @ndeloof in https://github.com/docker/compose/pull/14123 • Chore(deps):github.com/sirupsen/logrus v1.10.2, google.golang.org/grpc v1.83.2 by @thaJeztah in https://github.com/docker/compose/pull/14137 • Build:bump golangci-lint to v2.13.2 by @ndeloof in https://github.com/docker/compose/pull/14164 • Build(deps):bump github/codeql-action/upload-sarif from 4.37.7 to 4.37.9 by @dependabot[bot] in https://github.com/docker/compose/pull/14167 • Update to go1.26.8 by @thaJeztah in https://github.com/docker/compose/pull/14172 • Feat(deps):github.com/moby/buildkit v0.33.0 by @thaJeztah in https://github.com/docker/compose/pull/14171 • Build(deps):golang.org/x/crypto v0.56.0 by @thaJeztah in https://github.com/docker/compose/pull/14173 • Bump compose-go to version v2.15.0 by @glours in https://github.com/docker/compose/pull/14178

New Contributors

• @dennislapchenko made their first contribution in https://github.com/docker/compose/pull/14088

Full Changelog:https://github.com/docker/compose/compare/v5.5.0...v5.5.1

Installer type: portable

x64—A3C0C73033EAEDE90210345D0CC2233EDF4FAB8FE0282A91DAD8FD8436809D2F
arm64—4BBB5D1ECC75BDE1A9CA4AFAC43F5907C0D3BD0F88C7F00BF481EE7C8C1737BE

Details

Homepage
https://github.com/docker/compose
License
Apache-2.0
Publisher
Docker Inc.
Support
https://github.com/docker/compose/issues

Tags

clicomposecontainersdeveloper-toolsdockerdocker-compose

Older versions (37)

5.5.0
x64—51E1E61195F3616896265487ED64551095F3BD27AC7FBD5758D3538C3BFA1B19
arm64—673B844868A8EBAE57B81F3CFEFFCA8A00ED256E660A357C057191A40FFC83C2
5.4.0
x64—D51BC731B3FF6F062A26E8FDFD391AE98AEAB516432F097C66D39C1C9D06680E
arm64—7895808619A27DD6CBCA51B61AC211B59711ED82660B867B2C852D34E7881662
5.3.1
x64—6D36CC701393C066D67EBC77773B718D8C738BC4CCB350FBF1DC0E6A09F44CB9
arm64—5871699D19EE22904F7D1A7CE7E9E6B5A582F6CF9286AFD0117AD601CC6737D6
5.3.0
x64—EAC499928BCFDEAF0FE3DC9A783EB0BA5293188A2458C38730030E92A2759A20
arm64—C69EE136CD6C3318CF2683A722FB4D1DEC38C992D5E0CB2E2E06F0B1499018DA
5.2.0
x64—90C81AF6CD12227D84665B01E14A89B07920C42D6D04E8F6F391A415F7A8D6A4
arm64—709692084EE7D5066113CB9DBC2FBC26EDA503F52D51B08FFD263F2E0EB56A41
5.1.4
x64—E1A8FAFF28C7433635201A2222171B727F33ECDB0ED367E54D162D00432F39AA
arm64—11992BC5DE81D7DF994BDF58A4EEAD433F1C287C15965056A3B372AE38888AAF
5.1.3
x64—5E6D72612B3165BE9FEA4AE889435FEC76979A9779B6F62F4EFEE99DD5F41EA1
arm64—9BDABC5FB175161B93C41B2CE6464B816F8D2614E6B9641F5E0FDF20B188F4A2
5.1.2
x64—00E839301CA18EE5109B3EF086788F3A281C317C0B77BA42A06FC6F806401255
arm64—553C96849D49D029774304E56723884A2F8696C2EB516F546D349EF1C9D303BA
5.1.1
x64—F7AD2F6965C88153E4902019EC86E95414F0025CBA0B6440F328F935A1F8B12B
arm64—2C42D7600886BB56D9BB009F348B4F7F8C603C954C7B07BE3D53B3218877CE4A
5.1.0
x64—EE84E42B93C501CB0AA2CAA84D76B5F30CA6FB92F070E289FC37BE7332C5822A
arm64—3F3DD613A410F7060F3CB806F8A35602B27B8C6B62548E87CB20BD27B765B2EA
5.0.2
x64—E6281C7B906EAFE8F39114E735F11FC276D8CCE2CBA93A54911CA15337BA6C49
arm64—275CBBDEBB053BAC7A87808CFF75A24DB6E3C6B069EB76715B7A63CFD9FBB07E
5.0.1
x64—2AE341F9152B4D90F561F84B8F2E263D5B60E1613C6841C804447819290C4119
arm64—63AFF6ABC96D7B838AEF2646E1003435BDDD82774FF3E5EC2174A7C185A6D0C8
5.0.0
x64—E8A5338E20BC6D30AE38DB5533CE63EBF3C229801C20A74051FD06A650E5A8F9
arm64—E8B20D796313D29125DD4DB687636109145BC8944BBDE4412B85E06F224612D4
2.40.3
x64—4C864DD7F879DD40366E087E68A8A02CBCF018BE0128867B13369898E67E1532
arm64—881A70B6D6E9EA1637746B0D5DBDAF83032B2F7952D4EE4B69F8F38B816909D1
2.40.2
x64—1F7F20B91E0564147DC58B3A58A22A8F64A787E060CE3C25789F408BEACC0C4D
arm64—4ACF95D3276CFBAEA0E4C348F92F92AC792ADC93566B166B5A5ACEF812A81439
2.40.1
x64—BB701F3E71D27FD445581149A0D7F063DF88E07B4038C80BA9C56D528E7C840E
arm64—75DDD3A2F0121EFEE3AC241E0F4F9F9C8B37D39A6F126A5D5D89D9909CB9001F
2.40.0
x64—835B6A7150D12E128FA9FD902ABFF6212FF3E55398683D57E213956558EAD5DF
arm64—EDD7D5B17800835E29261BBD64EEE1FFB2D7793230A6C68616750F1254BC9F14
2.39.4
x64—6B3BCCFABCDD172E1D9E15D011B54C9B5B13B93B1153148108F55E4349055955
arm64—F33DF1EB9206432658276BBF0597B66B45FC0F3075A1C49A38B10F5CEB3A3590
2.39.3
x64—C6A724F026F4A65E7648FBA6E1B27EB5ABAA057E7DBF2BEEACC760F9DB723C01
arm64—C2E119E9554872242B832A938C33055C9897E5C8D90C3FD63F690B138A27DB57
2.39.2
x64—6580793B1F612150646A9F8D02148C8D226A0033ED6E2E3273C0229B25E2F158
arm64—3B39A6AFE1FA54B89DFEFAD9E7607318F7C7D221FC24CCB93E96B2953F94AF27
2.39.1
x64—5E0AE2DF1651C6BED38C5367D0D84D5169537EF5426B2EE32F34E4166233EFA7
arm64—199DE3889471DA98B3F67297F4A7E244177315F5603308ABF5F25AD6502CCACB
2.39.0
x64—42F8D1A03C32FDF73EC2C10C2C9D4F75E430DA798EC94743D86F188C5155C621
arm64—EFA2E51627D1072DD2383233CFFE397B2BE9A08A4727BBA79E829BB5955F8FF3
2.38.2
x64—BA8F09D3873F7A9755B863ED2013A1276B96FCBBC074C69FF3D3CFBCE3E0186F
arm64—3517FA88873214CE21BD23E8B250028AF434BF9A9A64AF8048DB88924314399B
2.38.1
x64—1F50233952BDCEF70D4B753112363A67E9AF0F56A2EABFC9BA60444879B81638
arm64—B063BEB4E2DE335C60EC8D62407635BAC54C2C85B9CBDBFED2A8654CF7F22404
2.37.3
x64—771FEE0BAD6DADDE4EA68D99EC9AEFAFFCAB2574AD70E64B54560E4E139EB804
arm64—34A520EB6D3858CE30A14A08DEC10C85B71F041582D9DC8CF3B4C6AEBF589538
2.37.2
x64—F52BBA6D8031DA7E01C5BCF621DADEA0AFA41A317BE09F2946701E15E899F8A4
arm64—1CB0FFDD4DFBF446F0300B96D64D1A18040AADEE9E939BB2CDFF8623E8613A4F
2.37.1
x64—132FB31EF7DC81A82D7B1429ADF3FD76CC0A7128059AF3A172945445A50F2801
arm64—6F0A78A707BF631D3C64BFD21C838DBD82443FAE99CF0B285AA140AFF62945F9
2.37.0
x64—5DDD1FF588EB7251381CF6257B9BE44FBB92C02D984CCFC94B4280E8C33D0F8F
arm64—7DBDDC0E6FE86B504BBA6C342F49725703048BCF1A9DD8A42B457DE24BFE51E8
2.36.2
x64—82EBEC0022949087F883B3DFFA0D7E57A2A141203AD31C012381D2754962C905
arm64—C838E1F14DCB50B11498CC7E00B2FAEB7816F422776D2800A62E47E039F56DAD
2.36.1
x64—0291C2F108655128DC36005D0C703869D9D98A1D403ED9BB8719356B9E5F2704
arm64—C87629502D5DA6FFBFCE4B72384F486BD562DB3F1F583D7613422C17B899675F
2.36.0
x64—9916CE82E444BB68E539AB36B947C2EDB95F74E5A640C2661255F2C340B5CFEE
arm64—01A14AF95A24AB589FAA12126F789D1FF49F515B3CD4CC12ABD0724452EE90F3
2.35.1
x64—971D6000E2C70DA19C20F8264330A7EC3962B1FD59601AFEB7E3636BAD89B8C9
arm64—D44D3EF8A5C94985090D2D792DC386D80F3D9268BBCD068EDE76C7FFD56E9B3C
2.35.0
x64—BCA44D55A7E612C53A80092661DD5DB05AEFB936E1ECCD7CE06FDB02BE7DF3C3
arm64—857DF8A710275345DCA13F35BE18A01FC866CB0A8BAC284A4377E47EF4D2C783
2.34.0
x64—3C6D3548D9DAE2939ADA367FFDF416AA0E2D282BC6A41D2B49EAA016994C112C
arm64—4E96A9CCB1713539D18D8006F29485234C152778B3531ED602884738F6BFD81F
2.32.4
x64—5DF58BB738C7AC2712C031E15154B49F32F4026640D8C0539090D6E0A66D6DFD
arm64—1D68182195B099410AD5AD19CA594E884096137E232E1FD5E2DA014612F79466
2.28.1
x64—7DBD8848D9B8DCE489C4D2CE1BB4F4B7A3DCCB07A08596AE98B85091E1645BCC
arm64—99921947DF0DC85BAC3995492EE6AB0DE6AEFDEA866EF304771071604ED2697F
2.23.3
x64—7D3F56CC84838CA54C5F0E9C8A3645DD96030482D838663C367D93BC6C38DC05
arm64—5E8FC62743039F3AA2E277F5DD66B00DD2ACF1A6A94E0A22D98CE8750F935607