Skip to content

Releases: containerd/nerdctl

v2.2.0-rc.0

02 Nov 09:27
v2.2.0-rc.0
930cd84

Choose a tag to compare

v2.2.0-rc.0 Pre-release
Pre-release

Changes

  • nerdctl run:

    • Fix namestore directory regression: /var/lib/nerdctl/1935db59/default/foo/var/lib/nerdctl/1935db59/names/default/foo(#4535, thanks to @yankay)
    • Support mount manager (e.g., for erofs) (#4568, thanks to @hsiangkao)
  • nerdctl checkpoint:

  • nerdctl image convert:

  • nerdctl-full:

    • Update containerd (2.2.0-rc.0), runc (1.3.2), BuildKit (0.25.1), stargz-snapshotter (0.18.0) (#4566, #4569, thanks to @ChengyuZhu6)

Full changes: https://github.com/containerd/nerdctl/milestone/57?closed=1
Thanks to @ChengyuZhu6 @coderbirju @escapefreeg @hsiangkao @smazmi @yankay

Compatible containerd versions

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

About the binaries

  • Minimal (nerdctl-2.2.0-rc.0-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.2.0-rc.0-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.2.0-rc.0-linux-amd64.tar.gz

-rwxr-xr-x root/root  29966520 2025-11-02 08:07 nerdctl
-rwxr-xr-x root/root     22657 2025-11-02 08:06 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8708 2025-11-02 08:06 containerd-rootless.sh

Full

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

tar Cxzvvf /usr/local nerdctl-full-2.2.0-rc.0-linux-amd64.tar.gz

drwxr-xr-x 0/0               0 2025-11-02 08:15 bin/
-rwxr-xr-x 0/0        32910671 2025-10-07 16:52 bin/buildctl
-rwxr-xr-x 0/0        29909144 2025-05-12 13:10 bin/buildg
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2025-11-02 08:14 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0        65278558 2025-10-07 16:52 bin/buildkitd
-rwxr-xr-x 0/0        16550016 2025-11-02 08:13 bin/bypass4netns
-rwxr-xr-x 0/0         6394040 2025-11-02 08:13 bin/bypass4netnsd
-rwxr-xr-x 0/0        43641984 2025-11-02 08:14 bin/containerd
-rwxr-xr-x 0/0        12021944 2025-05-20 18:06 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           22657 2025-11-02 08:15 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8708 2025-11-02 08:15 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8331448 2025-11-02 08:14 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0        56996024 2025-10-17 08:16 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0        23102810 2025-11-02 08:14 bin/ctd-decoder
-rwxr-xr-x 0/0        22098104 2025-11-02 08:13 bin/ctr
-rwxr-xr-x 0/0        30561742 2025-11-02 08:14 bin/ctr-enc
-rwxr-xr-x 0/0        23253176 2025-10-17 08:16 bin/ctr-remote
-rwxr-xr-x 0/0         1788872 2025-11-02 08:15 bin/fuse-overlayfs
-rwxr-xr-x 0/0         3985592 2025-11-02 08:13 bin/gomodjail
-rwxr-xr-x 0/0        29929656 2025-11-02 08:15 bin/nerdctl
-rwxr-xr-x 0/0        33922944 2025-11-02 08:15 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12236796 2025-05-08 06:00 bin/rootlessctl
-rwxr-xr-x 0/0        14176992 2025-05-08 06:00 bin/rootlesskit
-rwxr-xr-x 0/0        17775304 2025-11-02 08:13 bin/runc
-rwxr-xr-x 0/0         2383224 2025-11-02 08:15 bin/slirp4netns
-rwxr-xr-x 0/0        55578808 2025-10-17 08:16 bin/stargz-fuse-manager
-rwxr-xr-x 0/0        10793144 2025-10-17 08:16 bin/stargz-store-helper
-rwxr-xr-x 0/0          870496 2025-11-02 08:15 bin/tini
drwxr-xr-x 0/0               0 2025-11-02 08:14 lib/
drwxr-xr-x 0/0               0 2025-11-02 08:14 lib/systemd/
drwxr-xr-x 0/0               0 2025-11-02 08:14 lib/systemd/system/
-rw-r--r-- 0/0            1309 2025-11-02 08:14 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2025-11-02 08:12 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2025-11-02 08:14 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2025-11-02 08:14 libexec/
drwxr-xr-x 0/0               0 2025-09-01 15:29 libexec/cni/
-rw-r--r-- 0/0           11357 2025-09-01 15:29 libexec/cni/LICENSE
-rw-r--r-- 0/0            2343 2025-09-01 15:29 libexec/cni/README.md
-rwxr-xr-x 0/0         5042186 2025-09-01 15:29 libexec/cni/bandwidth
-rwxr-xr-x 0/0         5694189 2025-09-01 15:29 libexec/cni/bridge
-rwxr-xr-x 0/0        13719696 2025-09-01 15:29 libexec/cni/dhcp
-rwxr-xr-x 0/0         5251247 2025-09-01 15:29 libexec/cni/dummy
-rwxr-xr-x 0/0         5701763 2025-09-01 15:29 libexec/cni/firewall
-rwxr-xr-x 0/0         5159307 2025-09-01 15:29 libexec/cni/host-device
-rwxr-xr-x 0/0         4350430 2025-09-01 15:29 libexec/cni/host-local
-rwxr-xr-x 0/0         5273398 2025-09-01 15:29 libexec/cni/ipvlan
-rwxr-xr-x 0/0         4301450 2025-09-01 15:29 libexec/cni/loopback
-rwxr-xr-x 0/0         5306499 2025-09-01 15:29 libexec/cni/macvlan
-rwxr-xr-x 0/0         5107586 2025-09-01 15:29 libexec/cni/portmap
-rwxr-xr-x 0/0         5474778 2025-09-01 15:29 libexec/cni/ptp
-rwxr-xr-x 0/0         4521078 2025-09-01 15:29 libexec/cni/sbr
-rwxr-xr-x 0/0         3772408 2025-09-01 15:29 libexec/cni/static
-rwxr-xr-x 0/0         5330851 2025-09-01 15:29 libexec/cni/tap
-rwxr-xr-x 0/0         4384728 2025-09-01 15:29 libexec/cni/tuning
-rwxr-xr-x 0/0         5266939 2025-09-01 15:29 libexec/cni/vlan
-rwxr-xr-x 0/0         4684912 2025-09-01 15:29 libexec/cni/vrf
drwxr-xr-x 0/0               0 2025-11-02 08:12 share/
drwxr-xr-x 0/0               0 2025-11-02 08:15 share/doc/
drwxr-xr-x 0/0               0 2025-11-02 08:15 share/doc/nerdctl/
-rw-r--r-- 0/0           12101 2025-11-02 08:06 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2025-11-02 08:06 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2025-11-02 08:06 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2025-11-02 08:06 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2025-11-02 08:06 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           89194 2025-11-02 08:06 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1814 2025-11-02 08:06 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            7317 2025-11-02 08:06 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2025-11-02 08:06 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2025-11-02 08:06 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2025-11-02 08:06 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12701 2025-11-02 08:06 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8586 2025-11-02 08:06 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2879 2025-11-02 08:06 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2025-11-02 08:06 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14687 2025-11-02 08:06 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2025-11-02 08:06 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            3273 2025-11-02 08:06 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0            3419 2025-11-02 08:06 share/doc/nerdctl/docs/healthchecks.md
drwxr-xr-x 0/0               0 2025-11-02 08:06 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0            1540 2025-11-02 08:06 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0            1462 2025-11-02 08:06 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0          684421 2025-11-02 08:06 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0           14462 2025-11-02 08:06 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            2426 2025-11-02 08:06 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2960 2025-11-02 08:06 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2610 2025-11-02 08:06 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2025-11-02 08:06 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2025-11-02 08:06 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2025-11-02 08:06 ...
Read more

v2.1.6

30 Sep 15:38
v2.1.6
59253e9

Choose a tag to compare

Changes

  • rootful: reserve the ports on the host (#4526)

Full changes: https://github.com/containerd/nerdctl/milestone/56?closed=1

Compatible containerd versions

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

About the binaries

  • Minimal (nerdctl-2.1.6-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.1.6-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.1.6-linux-amd64.tar.gz

-rwxr-xr-x root/root  29647032 2025-09-30 15:18 nerdctl
-rwxr-xr-x root/root     22657 2025-09-30 15:17 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8708 2025-09-30 15:17 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2025-09-30 15:26 bin/
-rwxr-xr-x 0/0        33536339 2025-09-03 12:19 bin/buildctl
-rwxr-xr-x 0/0        29909144 2025-05-12 13:10 bin/buildg
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2025-09-30 15:25 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0        66476450 2025-09-03 12:19 bin/buildkitd
-rwxr-xr-x 0/0        16541728 2025-09-30 15:24 bin/bypass4netns
-rwxr-xr-x 0/0         6389944 2025-09-30 15:24 bin/bypass4netnsd
-rwxr-xr-x 0/0        41207168 2025-09-30 15:25 bin/containerd
-rwxr-xr-x 0/0        12021944 2025-05-20 18:06 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           22657 2025-09-30 15:26 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8708 2025-09-30 15:26 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8298680 2025-09-30 15:25 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0        57929912 2025-07-22 08:25 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0        23102830 2025-09-30 15:25 bin/ctd-decoder
-rwxr-xr-x 0/0        21643448 2025-09-30 15:24 bin/ctr
-rwxr-xr-x 0/0        30554301 2025-09-30 15:25 bin/ctr-enc
-rwxr-xr-x 0/0        22974648 2025-07-22 08:25 bin/ctr-remote
-rwxr-xr-x 0/0         1788872 2025-09-30 15:25 bin/fuse-overlayfs
-rwxr-xr-x 0/0         3985592 2025-09-30 15:24 bin/gomodjail
-rwxr-xr-x 0/0        29614264 2025-09-30 15:26 bin/nerdctl
-rwxr-xr-x 0/0        33607540 2025-09-30 15:26 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12236796 2025-05-08 06:00 bin/rootlessctl
-rwxr-xr-x 0/0        14176992 2025-05-08 06:00 bin/rootlesskit
-rwxr-xr-x 0/0        17767200 2025-09-30 15:24 bin/runc
-rwxr-xr-x 0/0         2383224 2025-09-30 15:25 bin/slirp4netns
-rwxr-xr-x 0/0        56516792 2025-07-22 08:25 bin/stargz-fuse-manager
-rwxr-xr-x 0/0        10772664 2025-07-22 08:25 bin/stargz-store-helper
-rwxr-xr-x 0/0          870496 2025-09-30 15:25 bin/tini
drwxr-xr-x 0/0               0 2025-09-30 15:25 lib/
drwxr-xr-x 0/0               0 2025-09-30 15:25 lib/systemd/
drwxr-xr-x 0/0               0 2025-09-30 15:25 lib/systemd/system/
-rw-r--r-- 0/0            1309 2025-09-30 15:25 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2025-09-30 15:23 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2025-09-30 15:25 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2025-09-30 15:25 libexec/
drwxr-xr-x 0/0               0 2025-09-01 15:29 libexec/cni/
-rw-r--r-- 0/0           11357 2025-09-01 15:29 libexec/cni/LICENSE
-rw-r--r-- 0/0            2343 2025-09-01 15:29 libexec/cni/README.md
-rwxr-xr-x 0/0         5042186 2025-09-01 15:29 libexec/cni/bandwidth
-rwxr-xr-x 0/0         5694189 2025-09-01 15:29 libexec/cni/bridge
-rwxr-xr-x 0/0        13719696 2025-09-01 15:29 libexec/cni/dhcp
-rwxr-xr-x 0/0         5251247 2025-09-01 15:29 libexec/cni/dummy
-rwxr-xr-x 0/0         5701763 2025-09-01 15:29 libexec/cni/firewall
-rwxr-xr-x 0/0         5159307 2025-09-01 15:29 libexec/cni/host-device
-rwxr-xr-x 0/0         4350430 2025-09-01 15:29 libexec/cni/host-local
-rwxr-xr-x 0/0         5273398 2025-09-01 15:29 libexec/cni/ipvlan
-rwxr-xr-x 0/0         4301450 2025-09-01 15:29 libexec/cni/loopback
-rwxr-xr-x 0/0         5306499 2025-09-01 15:29 libexec/cni/macvlan
-rwxr-xr-x 0/0         5107586 2025-09-01 15:29 libexec/cni/portmap
-rwxr-xr-x 0/0         5474778 2025-09-01 15:29 libexec/cni/ptp
-rwxr-xr-x 0/0         4521078 2025-09-01 15:29 libexec/cni/sbr
-rwxr-xr-x 0/0         3772408 2025-09-01 15:29 libexec/cni/static
-rwxr-xr-x 0/0         5330851 2025-09-01 15:29 libexec/cni/tap
-rwxr-xr-x 0/0         4384728 2025-09-01 15:29 libexec/cni/tuning
-rwxr-xr-x 0/0         5266939 2025-09-01 15:29 libexec/cni/vlan
-rwxr-xr-x 0/0         4684912 2025-09-01 15:29 libexec/cni/vrf
drwxr-xr-x 0/0               0 2025-09-30 15:23 share/
drwxr-xr-x 0/0               0 2025-09-30 15:26 share/doc/
drwxr-xr-x 0/0               0 2025-09-30 15:26 share/doc/nerdctl/
-rw-r--r-- 0/0           12101 2025-09-30 15:17 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2025-09-30 15:17 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2025-09-30 15:17 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2025-09-30 15:17 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2025-09-30 15:17 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           88905 2025-09-30 15:17 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1814 2025-09-30 15:17 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            7317 2025-09-30 15:17 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2025-09-30 15:17 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2025-09-30 15:17 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2025-09-30 15:17 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12701 2025-09-30 15:17 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8586 2025-09-30 15:17 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2879 2025-09-30 15:17 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2025-09-30 15:17 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14687 2025-09-30 15:17 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2025-09-30 15:17 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            3273 2025-09-30 15:17 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0            3419 2025-09-30 15:17 share/doc/nerdctl/docs/healthchecks.md
drwxr-xr-x 0/0               0 2025-09-30 15:17 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0            1540 2025-09-30 15:17 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0            1462 2025-09-30 15:17 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0          684421 2025-09-30 15:17 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0           14462 2025-09-30 15:17 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            2426 2025-09-30 15:17 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2960 2025-09-30 15:17 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2610 2025-09-30 15:17 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2025-09-30 15:17 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2025-09-30 15:17 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2025-09-30 15:17 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            9147 2025-09-30 15:17 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0            3933 2025-09-30 15:17 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0           10312 2025-09-30 15:17 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2025-09-30 15:17 share/doc/nerdctl/docs/testing/
-rw-r--r-- 0/0            4897 2025-09-30 15:17 share/doc/nerdctl/docs/testi...
Read more

v2.1.6-beta.0

29 Sep 14:10
v2.1.6-beta.0
ce40996

Choose a tag to compare

v2.1.6-beta.0 Pre-release
Pre-release

Changes

  • rootful: reserve the ports on the host (#4526)

Compatible containerd versions

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

About the binaries

  • Minimal (nerdctl-2.1.6-beta.0-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.1.6-beta.0-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.1.6-beta.0-linux-amd64.tar.gz

-rwxr-xr-x root/root  29647032 2025-09-29 13:54 nerdctl
-rwxr-xr-x root/root     22657 2025-09-29 13:54 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8708 2025-09-29 13:54 containerd-rootless.sh

Full

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

tar Cxzvvf /usr/local nerdctl-full-2.1.6-beta.0-linux-amd64.tar.gz

drwxr-xr-x 0/0               0 2025-09-29 14:03 bin/
-rwxr-xr-x 0/0        33536339 2025-09-03 12:19 bin/buildctl
-rwxr-xr-x 0/0        29909144 2025-05-12 13:10 bin/buildg
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2025-09-29 14:01 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0        66476450 2025-09-03 12:19 bin/buildkitd
-rwxr-xr-x 0/0        16541728 2025-09-29 14:01 bin/bypass4netns
-rwxr-xr-x 0/0         6389944 2025-09-29 14:01 bin/bypass4netnsd
-rwxr-xr-x 0/0        41207168 2025-09-29 14:01 bin/containerd
-rwxr-xr-x 0/0        12021944 2025-05-20 18:06 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           22657 2025-09-29 14:03 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8708 2025-09-29 14:03 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8298680 2025-09-29 14:01 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0        57929912 2025-07-22 08:25 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0        23102830 2025-09-29 14:02 bin/ctd-decoder
-rwxr-xr-x 0/0        21643448 2025-09-29 14:01 bin/ctr
-rwxr-xr-x 0/0        30554301 2025-09-29 14:02 bin/ctr-enc
-rwxr-xr-x 0/0        22974648 2025-07-22 08:25 bin/ctr-remote
-rwxr-xr-x 0/0         1788872 2025-09-29 14:02 bin/fuse-overlayfs
-rwxr-xr-x 0/0         3985592 2025-09-29 14:00 bin/gomodjail
-rwxr-xr-x 0/0        29614264 2025-09-29 14:03 bin/nerdctl
-rwxr-xr-x 0/0        33607540 2025-09-29 14:03 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12236796 2025-05-08 06:00 bin/rootlessctl
-rwxr-xr-x 0/0        14176992 2025-05-08 06:00 bin/rootlesskit
-rwxr-xr-x 0/0        17767200 2025-09-29 14:01 bin/runc
-rwxr-xr-x 0/0         2383224 2025-09-29 14:02 bin/slirp4netns
-rwxr-xr-x 0/0        56516792 2025-07-22 08:25 bin/stargz-fuse-manager
-rwxr-xr-x 0/0        10772664 2025-07-22 08:25 bin/stargz-store-helper
-rwxr-xr-x 0/0          870496 2025-09-29 14:02 bin/tini
drwxr-xr-x 0/0               0 2025-09-29 14:01 lib/
drwxr-xr-x 0/0               0 2025-09-29 14:01 lib/systemd/
drwxr-xr-x 0/0               0 2025-09-29 14:01 lib/systemd/system/
-rw-r--r-- 0/0            1309 2025-09-29 14:01 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2025-09-29 14:00 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2025-09-29 14:01 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2025-09-29 14:01 libexec/
drwxr-xr-x 0/0               0 2025-09-01 15:29 libexec/cni/
-rw-r--r-- 0/0           11357 2025-09-01 15:29 libexec/cni/LICENSE
-rw-r--r-- 0/0            2343 2025-09-01 15:29 libexec/cni/README.md
-rwxr-xr-x 0/0         5042186 2025-09-01 15:29 libexec/cni/bandwidth
-rwxr-xr-x 0/0         5694189 2025-09-01 15:29 libexec/cni/bridge
-rwxr-xr-x 0/0        13719696 2025-09-01 15:29 libexec/cni/dhcp
-rwxr-xr-x 0/0         5251247 2025-09-01 15:29 libexec/cni/dummy
-rwxr-xr-x 0/0         5701763 2025-09-01 15:29 libexec/cni/firewall
-rwxr-xr-x 0/0         5159307 2025-09-01 15:29 libexec/cni/host-device
-rwxr-xr-x 0/0         4350430 2025-09-01 15:29 libexec/cni/host-local
-rwxr-xr-x 0/0         5273398 2025-09-01 15:29 libexec/cni/ipvlan
-rwxr-xr-x 0/0         4301450 2025-09-01 15:29 libexec/cni/loopback
-rwxr-xr-x 0/0         5306499 2025-09-01 15:29 libexec/cni/macvlan
-rwxr-xr-x 0/0         5107586 2025-09-01 15:29 libexec/cni/portmap
-rwxr-xr-x 0/0         5474778 2025-09-01 15:29 libexec/cni/ptp
-rwxr-xr-x 0/0         4521078 2025-09-01 15:29 libexec/cni/sbr
-rwxr-xr-x 0/0         3772408 2025-09-01 15:29 libexec/cni/static
-rwxr-xr-x 0/0         5330851 2025-09-01 15:29 libexec/cni/tap
-rwxr-xr-x 0/0         4384728 2025-09-01 15:29 libexec/cni/tuning
-rwxr-xr-x 0/0         5266939 2025-09-01 15:29 libexec/cni/vlan
-rwxr-xr-x 0/0         4684912 2025-09-01 15:29 libexec/cni/vrf
drwxr-xr-x 0/0               0 2025-09-29 14:00 share/
drwxr-xr-x 0/0               0 2025-09-29 14:03 share/doc/
drwxr-xr-x 0/0               0 2025-09-29 14:03 share/doc/nerdctl/
-rw-r--r-- 0/0           12101 2025-09-29 13:54 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2025-09-29 13:54 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2025-09-29 13:54 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2025-09-29 13:54 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2025-09-29 13:54 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           88905 2025-09-29 13:54 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1814 2025-09-29 13:54 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            7317 2025-09-29 13:54 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2025-09-29 13:54 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2025-09-29 13:54 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2025-09-29 13:54 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12701 2025-09-29 13:54 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8586 2025-09-29 13:54 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2879 2025-09-29 13:54 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2025-09-29 13:54 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14687 2025-09-29 13:54 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2025-09-29 13:54 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            3273 2025-09-29 13:54 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0            3419 2025-09-29 13:54 share/doc/nerdctl/docs/healthchecks.md
drwxr-xr-x 0/0               0 2025-09-29 13:54 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0            1540 2025-09-29 13:54 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0            1462 2025-09-29 13:54 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0          684421 2025-09-29 13:54 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0           14462 2025-09-29 13:54 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            2426 2025-09-29 13:54 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2960 2025-09-29 13:54 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2610 2025-09-29 13:54 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2025-09-29 13:54 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2025-09-29 13:54 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2025-09-29 13:54 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            9147 2025-09-29 13:54 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0            3933 2025-09-29 13:54 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0           10312 2025-09-29 13:54 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2025-09-29 13:54 share/doc/nerdctl/docs/testing/
-rw-r--r-- 0/0            4897 2025-09-29 13:54 share/doc/nerdctl/docs/testing/README.md
-rw-r--r-- 0/0           15430 2025-09-29 13:54 share/doc/nerdctl/docs/testin...
Read more

v2.1.5

26 Sep 08:03
v2.1.5
645e11a

Choose a tag to compare

Changes

Full changes: https://github.com/containerd/nerdctl/milestone/55?closed=1

Thanks to @Swapnanil-Gupta @coderbirju @ningmingxiao @swagatbora90

Compatible containerd versions

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

About the binaries

  • Minimal (nerdctl-2.1.5-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.1.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.1.5-linux-amd64.tar.gz

-rwxr-xr-x root/root  29638840 2025-09-26 07:22 nerdctl
-rwxr-xr-x root/root     22657 2025-09-26 07:21 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8708 2025-09-26 07:21 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2025-09-26 07:30 bin/
-rwxr-xr-x 0/0        33536339 2025-09-03 12:19 bin/buildctl
-rwxr-xr-x 0/0        29909144 2025-05-12 13:10 bin/buildg
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2025-09-26 07:29 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0        66476450 2025-09-03 12:19 bin/buildkitd
-rwxr-xr-x 0/0        16541728 2025-09-26 07:28 bin/bypass4netns
-rwxr-xr-x 0/0         6389944 2025-09-26 07:28 bin/bypass4netnsd
-rwxr-xr-x 0/0        41207168 2025-09-26 07:29 bin/containerd
-rwxr-xr-x 0/0        12021944 2025-05-20 18:06 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           22657 2025-09-26 07:30 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8708 2025-09-26 07:30 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8298680 2025-09-26 07:29 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0        57929912 2025-07-22 08:25 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0        23102830 2025-09-26 07:29 bin/ctd-decoder
-rwxr-xr-x 0/0        21643448 2025-09-26 07:28 bin/ctr
-rwxr-xr-x 0/0        30554301 2025-09-26 07:29 bin/ctr-enc
-rwxr-xr-x 0/0        22974648 2025-07-22 08:25 bin/ctr-remote
-rwxr-xr-x 0/0         1788872 2025-09-26 07:29 bin/fuse-overlayfs
-rwxr-xr-x 0/0         3985592 2025-09-26 07:28 bin/gomodjail
-rwxr-xr-x 0/0        29606072 2025-09-26 07:30 bin/nerdctl
-rwxr-xr-x 0/0        33599348 2025-09-26 07:30 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12236796 2025-05-08 06:00 bin/rootlessctl
-rwxr-xr-x 0/0        14176992 2025-05-08 06:00 bin/rootlesskit
-rwxr-xr-x 0/0        17767200 2025-09-26 07:28 bin/runc
-rwxr-xr-x 0/0         2383224 2025-09-26 07:29 bin/slirp4netns
-rwxr-xr-x 0/0        56516792 2025-07-22 08:25 bin/stargz-fuse-manager
-rwxr-xr-x 0/0        10772664 2025-07-22 08:25 bin/stargz-store-helper
-rwxr-xr-x 0/0          870496 2025-09-26 07:29 bin/tini
drwxr-xr-x 0/0               0 2025-09-26 07:29 lib/
drwxr-xr-x 0/0               0 2025-09-26 07:29 lib/systemd/
drwxr-xr-x 0/0               0 2025-09-26 07:29 lib/systemd/system/
-rw-r--r-- 0/0            1309 2025-09-26 07:29 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2025-09-26 07:27 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2025-09-26 07:29 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2025-09-26 07:29 libexec/
drwxr-xr-x 0/0               0 2025-09-01 15:29 libexec/cni/
-rw-r--r-- 0/0           11357 2025-09-01 15:29 libexec/cni/LICENSE
-rw-r--r-- 0/0            2343 2025-09-01 15:29 libexec/cni/README.md
-rwxr-xr-x 0/0         5042186 2025-09-01 15:29 libexec/cni/bandwidth
-rwxr-xr-x 0/0         5694189 2025-09-01 15:29 libexec/cni/bridge
-rwxr-xr-x 0/0        13719696 2025-09-01 15:29 libexec/cni/dhcp
-rwxr-xr-x 0/0         5251247 2025-09-01 15:29 libexec/cni/dummy
-rwxr-xr-x 0/0         5701763 2025-09-01 15:29 libexec/cni/firewall
-rwxr-xr-x 0/0         5159307 2025-09-01 15:29 libexec/cni/host-device
-rwxr-xr-x 0/0         4350430 2025-09-01 15:29 libexec/cni/host-local
-rwxr-xr-x 0/0         5273398 2025-09-01 15:29 libexec/cni/ipvlan
-rwxr-xr-x 0/0         4301450 2025-09-01 15:29 libexec/cni/loopback
-rwxr-xr-x 0/0         5306499 2025-09-01 15:29 libexec/cni/macvlan
-rwxr-xr-x 0/0         5107586 2025-09-01 15:29 libexec/cni/portmap
-rwxr-xr-x 0/0         5474778 2025-09-01 15:29 libexec/cni/ptp
-rwxr-xr-x 0/0         4521078 2025-09-01 15:29 libexec/cni/sbr
-rwxr-xr-x 0/0         3772408 2025-09-01 15:29 libexec/cni/static
-rwxr-xr-x 0/0         5330851 2025-09-01 15:29 libexec/cni/tap
-rwxr-xr-x 0/0         4384728 2025-09-01 15:29 libexec/cni/tuning
-rwxr-xr-x 0/0         5266939 2025-09-01 15:29 libexec/cni/vlan
-rwxr-xr-x 0/0         4684912 2025-09-01 15:29 libexec/cni/vrf
drwxr-xr-x 0/0               0 2025-09-26 07:27 share/
drwxr-xr-x 0/0               0 2025-09-26 07:30 share/doc/
drwxr-xr-x 0/0               0 2025-09-26 07:30 share/doc/nerdctl/
-rw-r--r-- 0/0           12101 2025-09-26 07:21 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2025-09-26 07:21 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2025-09-26 07:21 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2025-09-26 07:21 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2025-09-26 07:21 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           88905 2025-09-26 07:21 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1814 2025-09-26 07:21 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            7317 2025-09-26 07:21 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2025-09-26 07:21 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2025-09-26 07:21 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2025-09-26 07:21 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12701 2025-09-26 07:21 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8586 2025-09-26 07:21 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2879 2025-09-26 07:21 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2025-09-26 07:21 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14687 2025-09-26 07:21 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2025-09-26 07:21 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            3273 2025-09-26 07:21 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0            3419 2025-09-26 07:21 share/doc/nerdctl/docs/healthchecks.md
drwxr-xr-x 0/0               0 2025-09-26 07:21 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0            1540 2025-09-26 07:21 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0            1462 2025-09-26 07:21 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0          684421 2025-09-26 07:21 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0           14462 2025-09-26 07:21 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            2426 2025-09-26 07:21 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2960 2025-09-26 07:21 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2610 2025-09-26 07:21 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2025-09-26 07:21 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2025-09-26 07:21 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2025-09-26 07:21 share/doc/nerdctl/docs/registry.md
-rw-r--r-...
Read more

v2.1.4

05 Sep 06:11
v2.1.4
d216470

Choose a tag to compare

This release adds many commands: nerdctl manifest (create|inspect|push|annotate|rm), nerdctl container export, and nerdctl image import.

Changes

  • nerdctl manifest create:
  • nerdctl manifest inspect:
  • nerdctl manifest push:
  • nerdctl manifest annotate:
  • nerdctl manifest rm:
  • nerdctl container inspect:
  • nerdctl container export:
  • nerdctl image import:
  • nerdctl network create:
    • Add com.docker.network.bridge.enable_icc network option (#4311, thanks to @swagatbora90)
    • Add --internal flag (#4454, thanks to @ChangyuZhu6)
  • nerdctl namespace ls:
  • nerdctl compose
  • nerdctl-full
    • Update containerd (2.1.4), runc (1.3.1), CNI plugins (1.8.0), BuildKit (0.24.0), gomodjail (0.1.3), stargz-snapshotter (0.17.0) etc. (#4490, #4494, #4505)
  • Project:

Full changes: https://github.com/containerd/nerdctl/milestone/54?closed=1
Thanks to @ChengyuZhu6 @Laitr0n @Shubhranshu153 @SpiffyEight77 @Swapnanil-Gupta @apostasie @craigloewen-msft @jonyhy96 @manugupt1 @ningmingxiao @swagatbora90 @tushar5526

Compatible containerd versions

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

Note

Since this release, nerdctl is no longer tested with containerd v1.6.

About the binaries

  • Minimal (nerdctl-2.1.4-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.1.4-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.1.4-linux-amd64.tar.gz

-rwxr-xr-x root/root  29589688 2025-09-05 05:52 nerdctl
-rwxr-xr-x root/root     22657 2025-09-05 05:51 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8708 2025-09-05 05:51 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2025-09-05 06:00 bin/
-rwxr-xr-x 0/0        33536339 2025-09-03 12:19 bin/buildctl
-rwxr-xr-x 0/0        29909144 2025-05-12 13:10 bin/buildg
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2025-09-05 05:59 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0        66476450 2025-09-03 12:19 bin/buildkitd
-rwxr-xr-x 0/0        16541728 2025-09-05 05:58 bin/bypass4netns
-rwxr-xr-x 0/0         6389944 2025-09-05 05:58 bin/bypass4netnsd
-rwxr-xr-x 0/0        41207168 2025-09-05 05:59 bin/containerd
-rwxr-xr-x 0/0        12021944 2025-05-20 18:06 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           22657 2025-09-05 06:00 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8708 2025-09-05 06:00 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8298680 2025-09-05 05:59 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0        57929912 2025-07-22 08:25 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0        23102830 2025-09-05 06:00 bin/ctd-decoder
-rwxr-xr-x 0/0        21643448 2025-09-05 05:58 bin/ctr
-rwxr-xr-x 0/0        30554301 2025-09-05 06:00 bin/ctr-enc
-rwxr-xr-x 0/0        22974648 2025-07-22 08:25 bin/ctr-remote
-rwxr-xr-x 0/0         1788872 2025-09-05 06:00 bin/fuse-overlayfs
-rwxr-xr-x 0/0         3985592 2025-09-05 05:58 bin/gomodjail
-rwxr-xr-x 0/0        29552824 2025-09-05 06:00 bin/nerdctl
-rwxr-xr-x 0/0        33546100 2025-09-05 06:00 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12236796 2025-05-08 06:00 bin/rootlessctl
-rwxr-xr-x 0/0        14176992 2025-05-08 06:00 bin/rootlesskit
-rwxr-xr-x 0/0        17767200 2025-09-05 05:58 bin/runc
-rwxr-xr-x 0/0         2383224 2025-09-05 06:00 bin/slirp4netns
-rwxr-xr-x 0/0        56516792 2025-07-22 08:25 bin/stargz-fuse-manager
-rwxr-xr-x 0/0        10772664 2025-07-22 08:25 bin/stargz-store-helper
-rwxr-xr-x 0/0          870496 2025-09-05 06:00 bin/tini
drwxr-xr-x 0/0               0 2025-09-05 05:59 lib/
drwxr-xr-x 0/0               0 2025-09-05 05:59 lib/systemd/
drwxr-xr-x 0/0               0 2025-09-05 05:59 lib/systemd/system/
-rw-r--r-- 0/0            1309 2025-09-05 05:59 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2025-09-05 05:57 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2025-09-05 05:59 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2025-09-05 05:59 libexec/
drwxr-xr-x 0/0               0 2025-09-01 15:29 libexec/cni/
-rw-r--r-- 0/0           11357 2025-09-01 15:29 libexec/cni/LICENSE
-rw-r--r-- 0/0            2343 2025-09-01 15:29 libexec/cni/README.md
-rwxr-xr-x 0/0         5042186 2025-09-01 15:29 libexec/cni/bandwidth
-rwxr-xr-x 0/0         5694189 2025-09-01 15:29 libexec/cni/bridge
-rwxr-xr-x 0/0        13719696 2025-09-01 15:29 libexec/cni/dhcp
-rwxr-xr-x 0/0         5251247 2025-09-01 15:29 libexec/cni/dummy
-rwxr-xr-x 0/0         5701763 2025-09-01 15:29 libexec/cni/firewall
-rwxr-xr-x 0/0         5159307 2025-09-01 15:29 libexec/cni/host-device
-rwxr-xr-x 0/0         4350430 2025-09-01 15:29 libexec/cni/host-local
-rwxr-xr-x 0/0         5273398 2025-09-01 15:29 libexec/cni/ipvlan
-rwxr-xr-x 0/0         4301450 2025-09-01 15:29 libexec/cni/loopback
-rwxr-xr-x 0/0         5306499 2025-09-01 15:29 libexec/cni/macvlan
-rwxr-xr-x 0/0         5107586 2025-09-01 15:29 libexec/cni/portmap
-rwxr-xr-x 0/0         5474778 2025-09-01 15:29 libexec/cni/ptp
-rwxr-xr-x 0/0         4521078 2025-09-01 15:29 libexec/cni/sbr
-rwxr-xr-x 0/0         3772408 2025-09-01 15:29 libexec/cni/static
-rwxr-xr-x 0/0         5330851 2025-09-01 15:29 libexec/cni/tap
-rwxr-xr-x 0/0         4384728 2025-09-01 15:29 libexec/cni/tuning
-rwxr-xr-x 0/0         5266939 2025-09-01 15:29 libexec/cni/vlan
-rwxr-xr-x 0/0         4684912 2025-09-01 15:29 libexec/cni/vrf
drwxr-xr-x 0/0               0 2025-09-05 05:57 share/
drwxr-xr-x 0/0               0 2025-09-05 06:00 share/doc/
drwxr-xr-x 0/0               0 2025-09-05 06:00 share/doc/nerdctl/
-rw-r--r-- 0/0           12101 2025-09-05 05:51 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2025-09-05 05:51 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2025-09-05 05:51 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2025-09-05 05:51 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2025-09-05 05:51 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           88905 2025-09-05 05:51 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1814 2025-09-05 05:51 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            7317 2025-09-05 05:51 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2025-09-05 05:51 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2025-09-05 05:51 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2025-09-05 05:51 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12701 2025-09-05 05:51 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8586 2025-09-05 05:51 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2879 2025-09-05 05:51 ...
Read more

v2.1.3

08 Jul 06:04
v2.1.3
ff93238

Choose a tag to compare

Changes

  • Healthcheck
  • nerdctl run
    • Support exposing a larger number of ports (#4290, thanks to @haytok)
  • nerdctl commit
  • nerdctl image convert
  • Config
  • IPFS
    • Support build tag no_ipfs to omit IPFS on compiling nerdctl (#4381)
  • nerdctl-full
    • Update containerd (2.1.3), BuildKit (0.23.2), slirp4netns (1.3.3) (#4404)

Full changes: https://github.com/containerd/nerdctl/milestone/53?closed=1
Thanks to @ChengyuZhu6 @Mr-Sunglasses @Shubhranshu153 @apostasie @coderbirju @fahedouch @haytok @jedevc @lengrongfu @ningmingxiao @pendo324 @subashkotha @swagatbora90 @tushar5526 @yankay @zzzzzzzzzy9

Compatible containerd versions

This release of nerdctl is expected to be used with containerd v1.6, v1.7, v2.0, or v2.1.

About the binaries

  • Minimal (nerdctl-2.1.3-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.1.3-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.1.3-linux-amd64.tar.gz

-rwxr-xr-x root/root  29302968 2025-07-08 05:46 nerdctl
-rwxr-xr-x root/root     22657 2025-07-08 05:46 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8708 2025-07-08 05:46 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2025-07-08 05:54 bin/
-rwxr-xr-x 0/0        33418241 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0        29909144 2025-05-12 13:10 bin/buildg
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2025-07-08 05:53 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0        66254451 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0        16439976 2025-07-08 05:52 bin/bypass4netns
-rwxr-xr-x 0/0         6320312 2025-07-08 05:52 bin/bypass4netnsd
-rwxr-xr-x 0/0        41071848 2025-07-08 05:53 bin/containerd
-rwxr-xr-x 0/0        12021944 2025-05-20 18:06 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           22657 2025-07-08 05:54 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8708 2025-07-08 05:54 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8270008 2025-07-08 05:53 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        23524550 2025-07-08 05:53 bin/ctd-decoder
-rwxr-xr-x 0/0        21594296 2025-07-08 05:52 bin/ctr
-rwxr-xr-x 0/0        31179269 2025-07-08 05:53 bin/ctr-enc
-rwxr-xr-x 0/0        21078168 2024-12-12 14:54 bin/ctr-remote
-rwxr-xr-x 0/0         1788872 2025-07-08 05:53 bin/fuse-overlayfs
-rwxr-xr-x 0/0         3936440 2025-07-08 05:52 bin/gomodjail
-rwxr-xr-x 0/0        29266104 2025-07-08 05:54 bin/nerdctl
-rwxr-xr-x 0/0        33210256 2025-07-08 05:54 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12236796 2025-05-08 06:00 bin/rootlessctl
-rwxr-xr-x 0/0        14176992 2025-05-08 06:00 bin/rootlesskit
-rwxr-xr-x 0/0        17888000 2025-07-08 05:52 bin/runc
-rwxr-xr-x 0/0         2383224 2025-07-08 05:53 bin/slirp4netns
-rwxr-xr-x 0/0         9707672 2024-12-12 14:54 bin/stargz-store-helper
-rwxr-xr-x 0/0          870496 2025-07-08 05:53 bin/tini
drwxr-xr-x 0/0               0 2025-07-08 05:53 lib/
drwxr-xr-x 0/0               0 2025-07-08 05:53 lib/systemd/
drwxr-xr-x 0/0               0 2025-07-08 05:53 lib/systemd/system/
-rw-r--r-- 0/0            1309 2025-07-08 05:53 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2025-07-08 05:51 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2025-07-08 05:53 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2025-07-08 05:53 libexec/
drwxr-xr-x 0/0               0 2025-04-25 12:58 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-07-08 05:51 share/
drwxr-xr-x 0/0               0 2025-07-08 05:54 share/doc/
drwxr-xr-x 0/0               0 2025-07-08 05:54 share/doc/nerdctl/
-rw-r--r-- 0/0           12101 2025-07-08 05:46 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2025-07-08 05:46 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2025-07-08 05:46 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2025-07-08 05:46 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2025-07-08 05:46 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           85226 2025-07-08 05:46 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1814 2025-07-08 05:46 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            7317 2025-07-08 05:46 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2025-07-08 05:46 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2025-07-08 05:46 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2025-07-08 05:46 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12858 2025-07-08 05:46 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8586 2025-07-08 05:46 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2879 2025-07-08 05:46 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2025-07-08 05:46 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14687 2025-07-08 05:46 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2025-07-08 05:46 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            3273 2025-07-08 05:46 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0            2248 2025-07-08 05:46 share/doc/nerdctl/docs/healthchecks.md
drwxr-xr-x 0/0               0 2025-07-08 05:46 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0            1540 2025-07-08 05:46 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0            1462 2025-07-08 05:46 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0          684421 2025-07-08 05:46 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0           14462 2025-07-08 05:46 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            2426 2025-07-08 05:46 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2960 2025-...
Read more

v2.1.2

20 May 19:14
v2.1.2
2a2834d

Choose a tag to compare

Changes

Bumped up the containerd library from v2.1.0 to v2.1.1, which contains the fix for CVE-2025-47290 (GHSA-cm76-qm8v-3j95) (#4274).
nerdctl v2.1.0 and v2.1.1 were affected by this vulnerability.

Other changes:

  • nerdctl run:
  • nerdctl attach:
  • nerdctl-full:
    • Change the build base from Alpine (musl) to Debian (glibc) (#4259, thanks to @apostasie)
    • Update containerd (2.1.1), containerd-fuse-overlayfs (2.1.6), buildg (0.5.3) (#4275)
  • Project:

Full changes: https://github.com/containerd/nerdctl/milestone/52?closed=1
Thanks to @apostasie @haytok @ningmingxiao @subashkotha

Compatible containerd versions

This release of nerdctl is expected to be used with containerd v1.6, v1.7, v2.0, or v2.1.

About the binaries

  • Minimal (nerdctl-2.1.2-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.1.2-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.1.2-linux-amd64.tar.gz

-rwxr-xr-x root/root  28614840 2025-05-20 18:57 nerdctl
-rwxr-xr-x root/root     22657 2025-05-20 18:57 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8708 2025-05-20 18:57 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2025-05-20 19:06 bin/
-rwxr-xr-x 0/0        31128678 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0        29909144 2025-05-12 13:10 bin/buildg
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2025-05-20 19:04 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2025-05-20 19:04 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        16439968 2025-05-20 19:04 bin/bypass4netns
-rwxr-xr-x 0/0         6320312 2025-05-20 19:04 bin/bypass4netnsd
-rwxr-xr-x 0/0        41059552 2025-05-20 19:04 bin/containerd
-rwxr-xr-x 0/0        12021944 2025-05-20 18:06 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           22657 2025-05-20 19:05 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8708 2025-05-20 19:05 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8270008 2025-05-20 19:04 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        23521766 2025-05-20 19:05 bin/ctd-decoder
-rwxr-xr-x 0/0        21590200 2025-05-20 19:04 bin/ctr
-rwxr-xr-x 0/0        31174373 2025-05-20 19:05 bin/ctr-enc
-rwxr-xr-x 0/0        21078168 2024-12-12 14:54 bin/ctr-remote
-rwxr-xr-x 0/0         1788872 2025-05-20 19:05 bin/fuse-overlayfs
-rwxr-xr-x 0/0         3936440 2025-05-20 19:03 bin/gomodjail
-rwxr-xr-x 0/0        28582072 2025-05-20 19:05 bin/nerdctl
-rwxr-xr-x 0/0        32526317 2025-05-20 19:06 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12236796 2025-05-08 06:00 bin/rootlessctl
-rwxr-xr-x 0/0        14176992 2025-05-08 06:00 bin/rootlesskit
-rwxr-xr-x 0/0        17888000 2025-05-20 19:04 bin/runc
-rwxr-xr-x 0/0         2383224 2025-05-20 19:05 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-20 19:05 bin/tini
drwxr-xr-x 0/0               0 2025-05-20 19:04 lib/
drwxr-xr-x 0/0               0 2025-05-20 19:04 lib/systemd/
drwxr-xr-x 0/0               0 2025-05-20 19:04 lib/systemd/system/
-rw-r--r-- 0/0            1309 2025-05-20 19:04 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2025-05-20 19:03 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2025-05-20 19:04 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2025-05-20 19:04 libexec/
drwxr-xr-x 0/0               0 2025-04-25 12:58 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-20 19:03 share/
drwxr-xr-x 0/0               0 2025-05-20 19:06 share/doc/
drwxr-xr-x 0/0               0 2025-05-20 19:06 share/doc/nerdctl/
-rw-r--r-- 0/0           12101 2025-05-20 18:57 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2025-05-20 18:57 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2025-05-20 18:57 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2025-05-20 18:57 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2025-05-20 18:57 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           83045 2025-05-20 18:57 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1814 2025-05-20 18:57 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            6457 2025-05-20 18:57 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2025-05-20 18:57 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2025-05-20 18:57 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2025-05-20 18:57 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12859 2025-05-20 18:57 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8587 2025-05-20 18:57 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2776 2025-05-20 18:57 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2025-05-20 18:57 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14687 2025-05-20 18:57 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2025-05-20 18:57 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            3273 2025-05-20 18:57 share/doc/nerdctl/docs/gpu.md
drwxr-xr-x 0/0               0 2025-05-20 18:57 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0            1540 2025-05-20 18:57 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0            1462 2025-05-20 18:57 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0          684421 2025-05-20 18:57 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0           14462 2025-05-20 18:57 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            2426 2025-05-20 18:57 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2960 2025-05-20 18:57 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2610 2025-05-20 18:57 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2025-05-20 18:57 share/doc/nerdctl/docs/ocicrypt.md...
Read more

v2.1.1

12 May 11:31
v2.1.1
d16f340

Choose a tag to compare

Changes

  • Fixed the CI pipeline issue that prevented releasing binaries in v2.1.0 (#4242)

Compatible containerd versions

This release of nerdctl is expected to be used with containerd v1.6, v1.7, v2.0, or v2.1.

About the binaries

  • Minimal (nerdctl-2.1.1-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-2.1.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.1.1-linux-amd64.tar.gz

-rwxr-xr-x root/root  28582072 2025-05-12 11:15 nerdctl
-rwxr-xr-x root/root     22657 2025-05-12 11:15 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      8708 2025-05-12 11:15 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2025-05-12 11:23 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-12 11:22 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0               0 2025-05-12 11:22 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0               0 2025-05-12 11:22 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        16439968 2025-05-12 11:21 bin/bypass4netns
-rwxr-xr-x 0/0         6320312 2025-05-12 11:21 bin/bypass4netnsd
-rwxr-xr-x 0/0        41059552 2025-05-12 11:22 bin/containerd
-rwxr-xr-x 0/0        12021944 2025-05-08 05:52 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           22657 2025-05-12 11:23 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            8708 2025-05-12 11:23 bin/containerd-rootless.sh
-rwxr-xr-x 0/0         8270008 2025-05-12 11:22 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        23521766 2025-05-12 11:22 bin/ctd-decoder
-rwxr-xr-x 0/0        21590200 2025-05-12 11:21 bin/ctr
-rwxr-xr-x 0/0        31174373 2025-05-12 11:22 bin/ctr-enc
-rwxr-xr-x 0/0        21078168 2024-12-12 14:54 bin/ctr-remote
-rwxr-xr-x 0/0         1788872 2025-05-12 11:22 bin/fuse-overlayfs
-rwxr-xr-x 0/0         3936440 2025-05-12 11:21 bin/gomodjail
-rwxr-xr-x 0/0        28545208 2025-05-12 11:23 bin/nerdctl
-rwxr-xr-x 0/0        32489528 2025-05-12 11:23 bin/nerdctl.gomodjail
-rwxr-xr-x 0/0        12236796 2025-05-08 06:00 bin/rootlessctl
-rwxr-xr-x 0/0        14176992 2025-05-08 06:00 bin/rootlesskit
-rwxr-xr-x 0/0        17888000 2025-05-12 11:21 bin/runc
-rwxr-xr-x 0/0         2383224 2025-05-12 11:22 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-12 11:22 bin/tini
drwxr-xr-x 0/0               0 2025-05-12 11:22 lib/
drwxr-xr-x 0/0               0 2025-05-12 11:22 lib/systemd/
drwxr-xr-x 0/0               0 2025-05-12 11:22 lib/systemd/system/
-rw-r--r-- 0/0            1309 2025-05-12 11:22 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1248 2025-05-12 11:20 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2025-05-12 11:22 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2025-05-12 11:22 libexec/
drwxr-xr-x 0/0               0 2025-05-12 11:22 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-12 11:20 share/
drwxr-xr-x 0/0               0 2025-05-12 11:23 share/doc/
drwxr-xr-x 0/0               0 2025-05-12 11:23 share/doc/nerdctl/
-rw-r--r-- 0/0           12101 2025-05-12 11:15 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2025-05-12 11:15 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2025-05-12 11:15 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2025-05-12 11:15 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            4779 2025-05-12 11:15 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           82941 2025-05-12 11:15 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1814 2025-05-12 11:15 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            6457 2025-05-12 11:15 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2025-05-12 11:15 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            5660 2025-05-12 11:15 share/doc/nerdctl/docs/cvmfs.md
drwxr-xr-x 0/0               0 2025-05-12 11:15 share/doc/nerdctl/docs/dev/
-rw-r--r-- 0/0           12859 2025-05-12 11:15 share/doc/nerdctl/docs/dev/auditing_dockerfile.md
-rw-r--r-- 0/0            8587 2025-05-12 11:15 share/doc/nerdctl/docs/dev/store.md
-rw-r--r-- 0/0            2776 2025-05-12 11:15 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2025-05-12 11:15 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14687 2025-05-12 11:15 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2025-05-12 11:15 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            3273 2025-05-12 11:15 share/doc/nerdctl/docs/gpu.md
drwxr-xr-x 0/0               0 2025-05-12 11:15 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0            1540 2025-05-12 11:15 share/doc/nerdctl/docs/images/nerdctl-white.svg
-rw-r--r-- 0/0            1462 2025-05-12 11:15 share/doc/nerdctl/docs/images/nerdctl.svg
-rw-r--r-- 0/0          684421 2025-05-12 11:15 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0           14462 2025-05-12 11:15 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            2426 2025-05-12 11:15 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2960 2025-05-12 11:15 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2610 2025-05-12 11:15 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2025-05-12 11:15 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2025-05-12 11:15 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2025-05-12 11:15 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            9147 2025-05-12 11:15 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0            2015 2025-05-12 11:15 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0           10312 2025-05-12 11:15 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2025-05-12 11:15 share/doc/nerdctl/docs/testing/
-rw-r--r-- 0/0            4897 2025-05-12 11:15 share/doc/nerdctl/docs/testing/README.md
-rw-r--r-- 0/0           15708 2025-05-12 11:15 share/doc/nerdctl/docs/testing/tools.md
drwxr-xr-x 0/0               0 2025-05-12 11:23 share/doc/nerdctl-full/
-rw-r--r-- 0/0          ...
Read more

v2.1.0

12 May 09:27
v2.1.0
0b7f069

Choose a tag to compare

v2.1.0 Pre-release
Pre-release

Note

Binaries are missing in this release due to a bug in the CI pipeline (#4241).
The issue was fixed in v2.1.1.

Changes

  • Experimental support for gomodjail: jail for Go modules (#4012).
    gomodjail imposes syscall restrictions on a specific set of Go modules, so as to mitigate their potential vulnerabilities and supply chain attack vectors (see caveats).
    Use the nerdctl.gomodjail binary included in the nerdctl-full archive.

  • Initial support for UserNS-remap mode (#3941, thanks to @Shubhranshu153).
    UserNS-remap can be considered a middle between Rootless and Rootful.
    In the case of UserNS-remap, the daemon is executed with root privileges, while the containers are executed as a non-root user, to balance security and performance.
    To enable UserNS-remap mdoe, specify userns_remap = <USERNAME> in nerdctl.toml, and run nerdctl as root.

  • nerdctl run:

    • Support Container Device Interface (CDI) in --device=example.com/device=foo flag (#4170, thanks to @elezar and @djdongjin)
  • nerdctl ps:

  • nerdctl logs:

  • Rootless:

    • Fix exec: \"iptables\": executable file not found in $PATH error on Debian, etc. (#4208)
  • Misc:

  • nerdctl-full:

    • Update containerd (2.1.0), RootlessKit (2.3.5), fuse-overlayfs (1.15), containerd-fuse-overlayfs (2.1.5) (#4179, #4217, #4227, thanks to @Shubhranshu153)

Full changes: https://github.com/containerd/nerdctl/pulls?q=is%3Apr+milestone%3Av2.1.0+is%3Aclosed

Thanks to @Shubhranshu153 @apostasie @djdongjin @fahedouch @zhaixiaojuan

v2.0.5

01 May 03:26
v2.0.5
fb3b8c1

Choose a tag to compare

Changes

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:...
Read more