containerd/containerd v2.1.4 Release Notes

Published at: 2025-07-30T18:51:10Z

Welcome to the v2.1.4 release of containerd!

The fourth patch release for containerd 2.1 contains various fixes and updates.

Highlights

Container Runtime Interface (CRI)

Fix containerd panic when sandbox extension is missing (#12076)
Update status response to return stable order for runtime handlers (#12054)

Go client

Fix lazy gRPC connection mode waiting for connect on client creation (#12079)

Image Distribution

Fix resolve deadlock issue in docker fetcher open (#12127)

Image Storage

Update erofs snapshotter to make immutable optional (#12091)
Fix erofs filesystem UUID for tar-converted layers (#12058)

Runtime

Fix close container io not closed when runtime create failed (#12009)

Please try out the release binaries and report any issues at https://github.com/containerd/containerd/issues.

Contributors

Derek McGowan
Phil Estes
Eric Mountain
Maksym Pavlenko
Gao Xiang
Kirtana Ashok
ningmingxiao
Akihiro Suda
Austin Vazquez
Paweł Gronowski
Sebastiaan van Stijn
Wei Fu
jinda.ljd

Changes

26 commits

Prepare release notes for v2.1.4 (#12159)
- 112e41363 Add release notes for v2.1.4
Fix resolve deadlock issue in docker fetcher open (#12127)
- add2dcf86 Ensure fetcher always closes body and properly calls release
- 34a1cb1dd fix(dockerFetcher): resolve deadlock issue in dockerFetcher open
ci: bump Go 1.23.11, 1.24.5 (#12115)
- 82c4d6875 ci: bump Go 1.23.11, 1.24.5
Backport windows test fixes (#12119)
- 6cc2a8d77 Fix intermittent test failures on Windows CIs
- 6adc69312 Remove WS2025 from CIs due to regression
Update erofs snapshotter to make immutable optional (#12091)
- 8d194c19f erofs-snapshotter: make IMMUTABLE_FL optional
Fix lazy gRPC connection mode waiting for connect on client creation (#12079)
- 2df7175d7 client/New: Don’t unlazy the gRPC connection implicitly
backport: update go-md2man binary to v2.0.7 (#12074)
- 4902adb92 update go-md2man binary to v2.0.7
Fix containerd panic when sandbox extension is missing (#12076)
- 02298e1a0 cri:fix containerd panic when can’t find sandbox extension
Fix erofs filesystem UUID for tar-converted layers (#12058)
- 583133e71 erofs-differ: fix filesystem UUID for tar-converted layers
Update status response to return stable order for runtime handlers (#12054)
- 57db13d50 Amend runtime handler test for stable order
- d822c9048 CRI: Stable sort for RuntimeHandlers
- a2fd70639 Test showing RuntimeHandlers in Status() are unordered
Fix close container io not closed when runtime create failed (#12009)
- b74268f86 bugfix:close container io when runtime create failed

Dependency Changes

This release has no dependency changes

Previous release can be found at v2.1.3

Which file should I download?

containerd-<VERSION>-<OS>-<ARCH>.tar.gz: ✅Recommended. Dynamically linked with glibc 2.35 (Ubuntu 22.04).
containerd-static-<VERSION>-<OS>-<ARCH>.tar.gz: Statically linked. Expected to be used on Linux distributions that do not use glibc >= 2.35. Not position-independent.

In addition to containerd, typically you will have to install runc and CNI plugins from their official sites too.

See also the Getting Started documentation.

Containerd V2.1.3 Release Note Containerd V2.1.5 Release Note