# containerd v2.4.0-beta.0 — containerd 2.4.0-beta.0

- Product: containerd (https://whatsnew.fyi/product/containerd)
- Vendor: CNCF
- Date: 2026-08-10
- Version: v2.4.0-beta.0
- Original notes: https://github.com/containerd/containerd/releases/tag/v2.4.0-beta.0
- Permalink: https://whatsnew.fyi/product/containerd/releases/v2.4.0-beta.0
- Labels: Pre-release

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Include media type in content create event
- **added** — Support warm image cache for erofs snapshotter
- **added** — Add parent path to runc checkpoint options
- **added** — Introspect OCI runtime features for non-runc runtimes
- **changed** — Use klauspost/compress/gzip for decode
- **added** — Add forward References to the GC collection context
- **added** — Add max size label for snapshots
- **removed** — Remove restore in CreateContainer
- **fixed** — Fix sandbox task API endpoints for non-runc runtimes

Welcome to the v2.4.0-beta.0 release of containerd!
*This is a pre-release of containerd*

containerd 2.4 is a regular (non-LTS) release with a shorter support window,
intended for users who want to adopt new features sooner. As the release
following the 2.3 LTS, it is the point in the release cycle where previously
deprecated features may be removed, so this release may include breaking
changes; check the notes below and clear any deprecation warnings from your
current version before upgrading.

Users prioritizing stability and a longer support lifecycle should stay on the
2.3 LTS release.

This is a beta release and some functionality is still under development.

###### Highlights

* **Include media type in content create event** ([#13833](https://github.com/containerd/containerd/pull/13833))
* **Support warm image cache for erofs snapshotter** ([#13813](https://github.com/containerd/containerd/pull/13813))
* **Add parent path to runc checkpoint options** ([#13699](https://github.com/containerd/containerd/pull/13699))

###### Container Runtime Interface (CRI)

* **Introspect OCI runtime features for non-runc runtimes** ([#13504](https://github.com/containerd/containerd/pull/13504))

###### Image Distribution

* **Use klauspost/compress/gzip for decode** ([#13560](https://github.com/containerd/containerd/pull/13560))

###### Image Storage

* **Add forward References to the GC collection context** ([#13634](https://github.com/containerd/containerd/pull/13634))

###### Snapshotters

* **Add max size label for snapshots** ([#13520](https://github.com/containerd/containerd/pull/13520))

###### Breaking

* Remove restore in CreateContainer ([#13871](https://github.com/containerd/containerd/pull/13871))

###### Deprecations

* **Fix sandbox task API endpoints for non-runc runtimes** ([#13360](https://github.com/containerd/containerd/pull/13360))

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

###### Contributors

* Maksym Pavlenko
* Samuel Karp
* Akihiro Suda
* Derek McGowan
* Wei Fu
* Sebastiaan van Stijn
* Chris Henzie
* Paweł Gronowski
* Mike Brown
* Brian Goff
* Jordan Liggitt
* Austin Vazquez
* Kazuyoshi Kato
* Kir Kolyshkin
* Phil Estes
* Sergey Kanzhelev
* ningmingxiao
* Ahmet Alp Balkan
* Akhil Mohan
* Chris Ayoub
* Damien Grisonnet
* Esteban Ginez
* Laura Lorenz
* Maksim An
* Abhishek Bhunia
* Alan Grosskurth
* Albin Kerouanton
* Alex Lyn
* Aman Raj
* Amir Alavi
* Amit Barve
* Andrew Halaney
* AprilNEA
* Arjun Yogidas
* Ayato Tokubi
* Aysha Afrah Ziya
* Ben Cressey
* Bing Hongtao
* Chris Crone
* Craig Gumbley
* Daniel De Graaf
* Davanum Srinivas
* Dr. Jan-Philip Gehrcke
* Gao Xiang
* Harshal Patel
* Henry Wang
* Kohei Tokunaga
* Krisztian Litkey
* LEI WANG
* Mikhail Dmitrichenko
* Nikolaus Schuetz
* Paco Xu
* Philip Laine
* SaloniRathi
* Tianon Gravi
* ayush-panta
* crawfordxx
* cshung
* s3onghyun
* 归寂
* 徐晓伟

###### Dependency Changes

* **cyphar.com/go-pathrs**                                                         v0.2.1 -> v0.2.4
* **github.com/Microsoft/hcsshim**                                                 v0.15.0-rc.1 -> v0.15.0-rc.3
* **github.com/ProtonMail/go-crypto**                                              v1.4.1 **_new_**
* **github.com/cilium/ebpf**                                                       v0.16.0 -> v0.17.3
* **github.com/cloudflare/circl**                                                  v1.6.3 **_new_**
* **github.com/containerd/containerd/api**                                         v1.11.0 -> v1.12.0-beta.0
* **github.com/containerd/imgcrypt/v2**                                            v2.0.2 -> v2.0.3
* **github.com/containerd/nri**                                                    v0.12.0 -> v0.12.1
* **github.com/containerd/ttrpc**                                                  v1.2.8 -> v1.2.9
* **github.com/containerd/typeurl/v2**                                             v2.2.3 -> v2.3.0
* **github.com/cont

_[Truncated at 4000 characters — full notes: https://github.com/containerd/containerd/releases/tag/v2.4.0-beta.0]_