Skip to content

nerdctl 2.3.1#284060

Open
BrewTestBot wants to merge 1 commit into
mainfrom
bump-nerdctl-2.3.1
Open

nerdctl 2.3.1#284060
BrewTestBot wants to merge 1 commit into
mainfrom
bump-nerdctl-2.3.1

Conversation

@BrewTestBot
Copy link
Copy Markdown
Contributor

Created by brew bump


Created with brew bump-formula-pr.

Details

release notes
## Changes
This is the release of nerdctl v2.3.1.

This is a patch release for v2.3.0. It promotes the v2.3.x line to a GA release by updating nerdctl-full to use the stable containerd v2.3.1 instead of the beta containerd build used in v2.3.0.

Major changes:

  • nerdctl compose:
    • Added support for the Compose healthcheck field in service configs (#4869, thanks to @opjt)
    • Added support for passing service names to nerdctl compose down (#4901, thanks to @ysedira)
  • nerdctl network:
    • Fixed a panic when statting an invalid CNI config path (#4890, thanks to @immanuwell)
  • nerdctl-full:
    • Updated containerd to v2.3.1, BuildKit to v0.30.0, and gomodjail to v0.3.2 (#4887, #4922)
  • Documentation:
    • Fixed the spelling of the --sig-proxy flag in the command reference (#4903, thanks to @MukundaKatta)
    • Removed a stray quote from the --interactive flag documentation (#4904, thanks to @MukundaKatta)
  • CI and tests:
    • Added zizmor workflow linting and fixed reported workflow issues (#4909, thanks to @omribz156)
    • Continued migrating container tests to Tigron (#4863, #4865, thanks to @opjt)

Full changes: https://github.com/containerd/nerdctl/milestone/61?closed=1
Thanks to @ChengyuZhu6, @opjt, @immanuwell, @ysedira, @MukundaKatta, and @omribz156.

Compatible containerd versions

This release of nerdctl is expected to be used with containerd v1.7, v2.0, v2.1, v2.2, or v2.3.
Some features may not work with other releases of containerd.

About the binaries

  • Minimal (nerdctl-2.3.1-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.3.1-linux-amd64.tar.gz): Includes dependencies such as containerd, runc, and CNI

Minimal

Extract the archive to a path like /usr/local/bin or ~/bin .

tar Cxzvvf /usr/local/bin nerdctl-2.3.1-linux-amd64.tar.gz

-rwxr-xr-x root/root  31604898 2026-05-21 14:25 nerdctl
-rwxr-xr-x root/root     23381 2026-05-21 14:24 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8639 2026-05-21 14:24 containerd-rootless.sh

Full

Extract the archive to a path like /usr/local or ~/.local .

tar Cxzvvf /usr/local nerdctl-full-2.3.1-linux-amd64.tar.gz

drwxr-xr-x 0/0               0 2026-05-21 14:33 bin/
-rwxr-xr-x 0/0        34502474 2026-05-13 11:39 bin/buildctl
-rwxr-xr-x 0/0        29909144 2025-05-12 13:10 bin/buildg
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2026-05-21 14:32 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0        78723496 2026-05-13 11:39 bin/buildkitd
-rwxr-xr-x 0/0        16853648 2026-05-21 14:31 bin/bypass4netns
-rwxr-xr-x 0/0         6607010 2026-05-21 14:31 bin/bypass4netnsd
-rwxr-xr-x 0/0        39455632 2026-05-21 14:32 bin/containerd
-rwxr-xr-x 0/0        12079288 2025-11-06 01:44 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           23381 2026-05-21 14:33 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8639 2026-05-21 14:33 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8458402 2026-05-21 14:32 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0        55267512 2026-01-21 14:59 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0        23592203 2026-05-21 14:33 bin/ctd-decoder
-rwxr-xr-x 0/0        22577314 2026-05-21 14:32 bin/ctr
-rwxr-xr-x 0/0        31235586 2026-05-21 14:33 bin/ctr-enc
-rwxr-xr-x 0/0        23417016 2026-01-21 14:59 bin/ctr-remote
-rwxr-xr-x 0/0         1885808 2026-05-21 14:33 bin/fuse-overlayfs
-rwxr-xr-x 0/0         7913634 2026-05-21 14:31 bin/gomodjail
-rwxr-xr-x 0/0        31568034 2026-05-21 14:33 bin/nerdctl
-rwxr-xr-x 0/0        39489638 2026-05-21 14:33 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12034560 2026-04-09 19:03 bin/rootlessctl
-rwxr-xr-x 0/0        23451213 2026-04-09 19:03 bin/rootlesskit
-rwxr-xr-x 0/0        17088688 2026-05-21 14:31 bin/runc
-rwxr-xr-x 0/0        53829816 2026-01-21 14:59 bin/stargz-fuse-manager
-rwxr-xr-x 0/0        10821816 2026-01-21 14:59 bin/stargz-store-helper
-rwxr-xr-x 0/0          870496 2026-05-21 14:33 bin/tini
drwxr-xr-x 0/0               0 2026-05-21 14:32 lib/
drwxr-xr-x 0/0               0 2026-05-21 14:32 lib/systemd/
drwxr-xr-x 0/0               0 2026-05-21 14:32 lib/systemd/system/
-rw-r--r-- 0/0            1309 2026-05-21 14:32 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2026-05-21 14:30 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2026-05-21 14:32 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2026-05-21 14:32 libexec/
drwxr-xr-x 0/0               0 2026-03-16 14:18 libexec/cni/
-rw-r--r-- 0/0           11357 2026-03-16 14:18 libexec/cni/LICENSE
-rw-r--r-- 0/0            2343 2026-03-16 14:18 libexec/cni/README.md
-rwxr-xr-x 0/0         5042926 2026-03-16 14:18 libexec/cni/bandwidth
-rwxr-xr-x 0/0         5698763 2026-03-16 14:18 libexec/cni/bridge
-rwxr-xr-x 0/0        13725422 2026-03-16 14:18 libexec/cni/dhcp
-rwxr-xr-x 0/0         5251069 2026-03-16 14:18 libexec/cni/dummy
-rwxr-xr-x 0/0         5702145 2026-03-16 14:18 libexec/cni/firewall
-rwxr-xr-x 0/0         5159967 2026-03-16 14:18 libexec/cni/host-device
-rwxr-xr-x 0/0         4350778 2026-03-16 14:18 libexec/cni/host-local
-rwxr-xr-x 0/0         5274322 2026-03-16 14:18 libexec/cni/ipvlan
-rwxr-xr-x 0/0         4302030 2026-03-16 14:18 libexec/cni/loopback
-rwxr-xr-x 0/0         5307111 2026-03-16 14:18 libexec/cni/macvlan
-rwxr-xr-x 0/0         5108385 2026-03-16 14:18 libexec/cni/portmap
-rwxr-xr-x 0/0         5475470 2026-03-16 14:18 libexec/cni/ptp
-rwxr-xr-x 0/0         4525826 2026-03-16 14:18 libexec/cni/sbr
-rwxr-xr-x 0/0         3776708 2026-03-16 14:18 libexec/cni/static
-rwxr-xr-x 0/0         5453308 2026-03-16 14:18 libexec/cni/tap
-rwxr-xr-x 0/0         4389084 2026-03-16 14:18 libexec/cni/tuning
-rwxr-xr-x 0/0         5267679 2026-03-16 14:18 libexec/cni/vlan
-rwxr-xr-x 0/0         4685012 2026-03-16 14:18 libexec/cni/vrf
drwxr-xr-x 0/0               0 2026-05-21 14:30 share/
drwxr-xr-x 0/0               0 2026-05-21 14:33 share/doc/
drwxr-xr-x 0/0               0 2026-05-21 14:33 share/doc/nerdctl/
-rw-r--r-- 0/0           12036 2026-05-21 14:24 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2026-05-21 14:24 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2026-05-21 14:24 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2026-05-21 14:24 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2026-05-21 14:24 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           90467 2026-05-21 14:24 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1829 2026-05-21 14:24 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            7592 2026-05-21 14:24 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2026-05-21 14:24 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2026-05-21 14:24 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2026-05-21 14:24 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12701 2026-05-21 14:24 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8586 2026-05-21 14:24 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2879 2026-05-21 14:24 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2026-05-21 14:24 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14757 2026-05-21 14:24 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2026-05-21 14:24 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            5585 2026-05-21 14:24 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0            3419 2026-05-21 14:24 share/doc/nerdctl/docs/healthchecks.md
drwxr-xr-x 0/0               0 2026-05-21 14:24 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0            1540 2026-05-21 14:24 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0            1462 2026-05-21 14:24 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0          684421 2026-05-21 14:24 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0           14462 2026-05-21 14:24 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            2426 2026-05-21 14:24 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2960 2026-05-21 14:24 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2805 2026-05-21 14:24 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2026-05-21 14:24 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            2079 2026-05-21 14:24 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2026-05-21 14:24 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            9388 2026-05-21 14:24 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0            4126 2026-05-21 14:24 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0           11912 2026-05-21 14:24 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2026-05-21 14:24 share/doc/nerdctl/docs/testing/
-rw-r--r-- 0/0            4897 2026-05-21 14:24 share/doc/nerdctl/docs/testing/README.md
-rw-r--r-- 0/0           16500 2026-05-21 14:24 share/doc/nerdctl/docs/testing/tools.md
drwxr-xr-x 0/0               0 2026-05-21 14:33 share/doc/nerdctl-full/
-rw-r--r-- 0/0             904 2026-05-21 14:33 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            9331 2026-05-21 14:33 share/doc/nerdctl-full/SHA256SUMS

Included components

See share/doc/nerdctl-full/README.md:

# nerdctl (full distribution)
- nerdctl: v2.3.1
- containerd: v2.3.1
- runc: v1.4.2
- CNI plugins: v1.9.1
- BuildKit: v0.30.0
- Stargz Snapshotter: v0.18.2
- imgcrypt: v2.0.2
- bypass4netns: v0.4.2
- fuse-overlayfs: v1.16
- containerd-fuse-overlayfs: v2.1.7
- Tini: v0.19.0
- buildg: v0.5.3
- RootlessKit: v3.0.0
- gomodjail: v0.3.2@c145bb1e36fe0939c5fa0467f2477878dea8e3d9

## License
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.16/COPYING)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)

Quick start

Rootful

$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine

Rootless

$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine

Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .


The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/26232089277

The sha256sum of the SHA256SUMS file itself is 8a0586ff11d4d5a5d19d59494a10af8c6d41dd95ca72ff347f62d5288bc5131a .


Release manager: Chengyu Zhu (@ChengyuZhu6)

View the full release notes at https://github.com/containerd/nerdctl/releases/tag/v2.3.1.


@github-actions github-actions Bot added go Go use is a significant feature of the PR or issue linux-only Formula depends on Linux bump-formula-pr PR was created using `brew bump-formula-pr` labels May 21, 2026
@botantony botantony force-pushed the bump-nerdctl-2.3.1 branch from 88a132c to 0fe5857 Compare May 21, 2026 19:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bump-formula-pr PR was created using `brew bump-formula-pr` go Go use is a significant feature of the PR or issue linux-only Formula depends on Linux

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant