·
16 commits
to main
since this release
v2.0.5
AkihiroSuda
Akihiro Suda
This tag was signed with the committer’s verified signature.
AkihiroSuda
Akihiro Suda
Changes
-
nerdctl run- Add
--cpu-rt-periodand--cpu-rt-runtimeflags (#4078, thanks to @swagatbora90) - Fix double carriage returns with pty (#4054, thanks to @apostasie)
- Add
-
nerdctl logs- Add
--detailsflag (#4009, thanks to @SpiffyEight77)
- Add
-
nerdctl inspect- Add
envanduserproperties (#4007, thanks to @Shubhranshu153) - Fix incompatibility with Docker (array vs stream of array) (#3961, thanks to @weiyuhang2011)
- Add
-
nerdctl compose -
nerdctl system prune- Fix parsing
BUILDKIT_HOST(#4115, thanks to @Shubhranshu153)
- Fix parsing
-
CI:
- Lots of updates to the Tigron testing framework (several PRs, thanks to @apostasie)
- The binary release artifacts now have GitHub Actions Attestations (#4150, thanks to @manugupt1)
-
Misc:
- nerdctl can be now compiled on macOS, but no functional runtime yet (#3763, thanks to @slonopotamus)
-
nerdctl-full:- Update containerd (2.0.5), runc (1.3.0), CNI plugins (1.7.1), BuildKit (0.21.1), buildg (0.5.2), etc.
(#4125, #4162, #4178, thanks to @apostasie @ktock)
- Update containerd (2.0.5), runc (1.3.0), CNI plugins (1.7.1), BuildKit (0.21.1), buildg (0.5.2), etc.
Full changes: https://github.com/containerd/nerdctl/milestone/49?closed=1
Thanks to @Shubhranshu153 @SpiffyEight77 @apostasie @ark-j @biubiubiuboomboomboom @coderbirju @fahedouch @ktock @manugupt1 @slonopotamus @swagatbora90 @tushar5526 @weiyuhang2011 @yankay @zzzzzzzzzy9
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6, v1.7, or v2.0.
About the binaries
- Minimal (
nerdctl-2.0.5-linux-amd64.tar.gz): nerdctl only - Full (
nerdctl-full-2.0.5-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.0.5-linux-amd64.tar.gz
-rwxr-xr-x root/root 27738296 2025-05-01 03:11 nerdctl
-rwxr-xr-x root/root 22657 2025-05-01 03:11 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 8708 2025-05-01 03:11 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local or ~/.local .
tar Cxzvvf /usr/local nerdctl-full-2.0.5-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2025-05-01 03:18 bin/
-rwxr-xr-x 0/0 31128678 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 29851800 2025-04-25 14:13 bin/buildg
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0 0 2025-05-01 03:17 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0 63640138 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 16435872 2025-05-01 03:16 bin/bypass4netns
-rwxr-xr-x 0/0 6320312 2025-05-01 03:16 bin/bypass4netnsd
-rwxr-xr-x 0/0 39853568 2025-05-01 03:17 bin/containerd
-rwxr-xr-x 0/0 11874488 2025-03-19 10:45 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 22657 2025-05-01 03:18 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 8708 2025-05-01 03:18 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 8024248 2025-05-01 03:17 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 53432472 2024-12-12 14:54 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 23513077 2025-05-01 03:18 bin/ctd-decoder
-rwxr-xr-x 0/0 20512952 2025-05-01 03:16 bin/ctr
-rwxr-xr-x 0/0 31165204 2025-05-01 03:18 bin/ctr-enc
-rwxr-xr-x 0/0 21078168 2024-12-12 14:54 bin/ctr-remote
-rwxr-xr-x 0/0 1789968 2025-05-01 03:18 bin/fuse-overlayfs
-rwxr-xr-x 0/0 27705528 2025-05-01 03:18 bin/nerdctl
-rwxr-xr-x 0/0 12235661 2025-03-10 02:16 bin/rootlessctl
-rwxr-xr-x 0/0 14172281 2025-03-10 02:16 bin/rootlesskit
-rwxr-xr-x 0/0 17888216 2025-05-01 03:16 bin/runc
-rwxr-xr-x 0/0 2383224 2025-05-01 03:18 bin/slirp4netns
-rwxr-xr-x 0/0 9707672 2024-12-12 14:54 bin/stargz-store-helper
-rwxr-xr-x 0/0 870496 2025-05-01 03:18 bin/tini
drwxr-xr-x 0/0 0 2025-05-01 03:17 lib/
drwxr-xr-x 0/0 0 2025-05-01 03:17 lib/systemd/
drwxr-xr-x 0/0 0 2025-05-01 03:17 lib/systemd/system/
-rw-r--r-- 0/0 1325 2025-05-01 03:17 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1264 2025-05-01 03:15 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2025-05-01 03:17 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2025-05-01 03:17 libexec/
drwxr-xr-x 0/0 0 2025-05-01 03:17 libexec/cni/
-rw-r--r-- 0/0 11357 2025-04-25 12:58 libexec/cni/LICENSE
-rw-r--r-- 0/0 2343 2025-04-25 12:58 libexec/cni/README.md
-rwxr-xr-x 0/0 5033580 2025-04-25 12:58 libexec/cni/bandwidth
-rwxr-xr-x 0/0 5694447 2025-04-25 12:58 libexec/cni/bridge
-rwxr-xr-x 0/0 13924938 2025-04-25 12:58 libexec/cni/dhcp
-rwxr-xr-x 0/0 5247557 2025-04-25 12:58 libexec/cni/dummy
-rwxr-xr-x 0/0 5749447 2025-04-25 12:58 libexec/cni/firewall
-rwxr-xr-x 0/0 5163089 2025-04-25 12:58 libexec/cni/host-device
-rwxr-xr-x 0/0 4364143 2025-04-25 12:58 libexec/cni/host-local
-rwxr-xr-x 0/0 5269812 2025-04-25 12:58 libexec/cni/ipvlan
-rwxr-xr-x 0/0 4263979 2025-04-25 12:58 libexec/cni/loopback
-rwxr-xr-x 0/0 5305057 2025-04-25 12:58 libexec/cni/macvlan
-rwxr-xr-x 0/0 5125860 2025-04-25 12:58 libexec/cni/portmap
-rwxr-xr-x 0/0 5477120 2025-04-25 12:58 libexec/cni/ptp
-rwxr-xr-x 0/0 4488703 2025-04-25 12:58 libexec/cni/sbr
-rwxr-xr-x 0/0 3736370 2025-04-25 12:58 libexec/cni/static
-rwxr-xr-x 0/0 5332257 2025-04-25 12:58 libexec/cni/tap
-rwxr-xr-x 0/0 4352498 2025-04-25 12:58 libexec/cni/tuning
-rwxr-xr-x 0/0 5267833 2025-04-25 12:58 libexec/cni/vlan
-rwxr-xr-x 0/0 4644777 2025-04-25 12:58 libexec/cni/vrf
drwxr-xr-x 0/0 0 2025-05-01 03:15 share/
drwxr-xr-x 0/0 0 2025-05-01 03:18 share/doc/
drwxr-xr-x 0/0 0 2025-05-01 03:18 share/doc/nerdctl/
-rw-r--r-- 0/0 12101 2025-05-01 03:11 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2025-05-01 03:11 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2025-05-01 03:11 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2025-05-01 03:11 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 4779 2025-05-01 03:11 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 82374 2025-05-01 03:11 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1814 2025-05-01 03:11 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5814 2025-05-01 03:11 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2025-05-01 03:11 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2025-05-01 03:11 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0 0 2025-05-01 03:11 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0 12859 2025-05-01 03:11 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0 8587 2025-05-01 03:11 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0 2776 2025-05-01 03:11 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2025-05-01 03:11 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14687 2025-05-01 03:11 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2025-05-01 03:11 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 3273 2025-05-01 03:11 share/doc/nerdctl/docs/gpu.md
drwxr-xr-x 0/0 0 2025-05-01 03:11 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0 1540 2025-05-01 03:11 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0 1462 2025-05-01 03:11 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0 684421 2025-05-01 03:11 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0 14462 2025-05-01 03:11 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 2384 2025-05-01 03:11 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2960 2025-05-01 03:11 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2610 2025-05-01 03:11 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2025-05-01 03:11 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2025-05-01 03:11 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2025-05-01 03:11 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 9147 2025-05-01 03:11 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2025-05-01 03:11 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2025-05-01 03:11 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2025-05-01 03:11 share/doc/nerdctl/docs/testing/
-rw-r--r-- 0/0 4916 2025-05-01 03:11 share/doc/nerdctl/docs/testing/README.md
-rw-r--r-- 0/0 15708 2025-05-01 03:11 share/doc/nerdctl/docs/testing/tools.md
drwxr-xr-x 0/0 0 2025-05-01 03:18 share/doc/nerdctl-full/
-rw-r--r-- 0/0 999 2025-05-01 03:18 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 9232 2025-05-01 03:18 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md:
# nerdctl (full distribution)
- nerdctl: v2.0.5
- containerd: v2.0.5
- runc: v1.3.0
- CNI plugins: v1.7.1
- BuildKit: v0.21.1
- Stargz Snapshotter: v0.16.3
- imgcrypt: v2.0.1
- slirp4netns: v1.3.2
- bypass4netns: v0.4.2
- fuse-overlayfs: v1.14
- containerd-fuse-overlayfs: v2.1.2
- Tini: v0.19.0
- buildg: v0.5.2
- RootlessKit: v2.3.4
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.3.2/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.14/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:alpineRootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpineEnabling 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/14768916719
The sha256sum of the SHA256SUMS file itself is cfc904e61d33fda99b110d31b43a348b9ea42e3b23fb30ba8cdaccc62d2b2ba4 .
Release manager: @AkihiroSuda
Contributors
slonopotamus, manugupt1, and 14 other contributors