Releases: containerd/nerdctl
v2.0.0-beta.2
Changes
nerdctl v2 enables "detach-netns" for Rootless mode by default (#2723).
This will bring:
- Faster and more stable
nerdctl pull
,nerdctl push
,nerdctl build
, etc - Proper support for
nerdctl pull 127.0.0.1:.../...
- Proper support for
nerdctl run --net=host
Depends on RootlessKit v2 and BuildKit v0.13 (included in nerdctl-full-*.tar.gz
).
Note
After upgrading nerdctl (rootless mode) from v1.x to v2.x, it is highly recommended to
re-install the systemd units and the configurations:
containerd-rootless-setuptool.sh uninstall
rm -rf ~/.config/{nerdctl,buildkit}
containerd-rootless-setuptool.sh install
CONTAINERD_NAMESPACE=default containerd-rootless-setuptool.sh install-buildkit-containerd
Other major changes:
nerdctl run
:- Add
--systemd
flag for running systemd in containers flag (#2785, thanks to @sazzy4o) - Add
--ipc=(shareable|container:<container>)
flag (#2757, thanks to @minuk-dev)
- Add
nerdctl build
:nerdctl compose up
:- Add
--abort-on-container-exit
flag (#2873, thanks to @alegrey91)
- Add
Full changes: https://github.com/containerd/nerdctl/milestone/37?closed=1
Thanks to @Shubhranshu153 @alegrey91 @dmcgowan @fahedouch @jmpargana @manugupt1 @minuk-dev @monirul @roman-kiselenko @sazzy4o @testwill @yankay @zwpaper
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-2.0.0-beta.2-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-2.0.0-beta.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.0.0-beta.2-linux-amd64.tar.gz
-rwxr-xr-x root/root 25235456 2024-03-16 09:52 nerdctl
-rwxr-xr-x root/root 22764 2024-03-16 09:52 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 8640 2024-03-16 09:52 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-2.0.0-beta.2-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2024-03-16 09:59 bin/
-rwxr-xr-x 0/0 30010775 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-LICENSE -> ../libexec/cni/LICENSE
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-README.md -> ../libexec/cni/README.md
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0 0 2024-03-16 09:59 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0 57547522 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 7277848 2024-03-16 09:57 bin/bypass4netns
-rwxr-xr-x 0/0 5308416 2024-03-16 09:57 bin/bypass4netnsd
-rwxr-xr-x 0/0 38885048 2024-03-16 09:58 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 22764 2024-03-16 09:57 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 8640 2024-03-16 09:57 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2024-03-16 09:58 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20634745 2024-03-16 09:59 bin/ctd-decoder
-rwxr-xr-x 0/0 18771968 2024-03-16 09:58 bin/ctr
-rwxr-xr-x 0/0 29669409 2024-03-16 09:59 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2024-03-16 09:59 bin/fuse-overlayfs
-rwxr-xr-x 0/0 65588315 2024-03-16 09:58 bin/ipfs
-rwxr-xr-x 0/0 25206784 2024-03-16 09:57 bin/nerdctl
-rwxr-xr-x 0/0 10666181 2024-03-05 22:20 bin/rootlessctl
-rwxr-xr-x 0/0 12358373 2024-03-05 22:20 bin/rootlesskit
-rwxr-xr-x 0/0 15074064 2024-03-16 09:57 bin/runc
-rwxr-xr-x 0/0 2346328 2024-03-16 09:59 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2024-03-16 09:59 bin/tini
drwxr-xr-x 0/0 0 2024-03-16 09:58 lib/
drwxr-xr-x 0/0 0 2024-03-16 09:58 lib/systemd/
drwxr-xr-x 0/0 0 2024-03-16 09:59 lib/systemd/system/
-rw-r--r-- 0/0 1475 2024-03-16 09:59 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2024-03-16 09:56 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2024-03-16 09:59 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2024-03-16 09:59 libexec/
drwxr-xr-x 0/0 0 2024-03-16 09:59 libexec/cni/
-rw-r--r-- 0/0 11357 2024-03-12 10:56 libexec/cni/LICENSE
-rw-r--r-- 0/0 2343 2024-03-12 10:56 libexec/cni/README.md
-rwxr-xr-x 0/0 4119661 2024-03-12 10:56 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4662227 2024-03-12 10:56 libexec/cni/bridge
-rwxr-xr-x 0/0 11065251 2024-03-12 10:56 libexec/cni/dhcp
-rwxr-xr-x 0/0 4306546 2024-03-12 10:56 libexec/cni/dummy
-rwxr-xr-x 0/0 4751593 2024-03-12 10:56 libexec/cni/firewall
-rwxr-xr-x 0/0 4198427 2024-03-12 10:56 libexec/cni/host-device
-rwxr-xr-x 0/0 3560496 2024-03-12 10:56 libexec/cni/host-local
-rwxr-xr-x 0/0 4324636 2024-03-12 10:56 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3651038 2024-03-12 10:56 libexec/cni/loopback
-rwxr-xr-x 0/0 4355073 2024-03-12 10:56 libexec/cni/macvlan
-rwxr-xr-x 0/0 4095898 2024-03-12 10:56 libexec/cni/portmap
-rwxr-xr-x 0/0 4476535 2024-03-12 10:56 libexec/cni/ptp
-rwxr-xr-x 0/0 3861176 2024-03-12 10:56 libexec/cni/sbr
-rwxr-xr-x 0/0 3120090 2024-03-12 10:56 libexec/cni/static
-rwxr-xr-x 0/0 4381887 2024-03-12 10:56 libexec/cni/tap
-rwxr-xr-x 0/0 3743844 2024-03-12 10:56 libexec/cni/tuning
-rwxr-xr-x 0/0 4319235 2024-03-12 10:56 libexec/cni/vlan
-rwxr-xr-x 0/0 4008392 2024-03-12 10:56 libexec/cni/vrf
drwxr-xr-x 0/0 0 2024-03-16 09:57 share/
drwxr-xr-x 0/0 0 2024-03-16 09:57 share/doc/
drwxr-xr-x 0/0 0 2024-03-16 09:57 share/doc/nerdctl/
-rw-r--r-- 0/0 12390 2024-03-16 09:52 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2024-03-16 09:52 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2024-03-16 09:52 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2024-03-16 09:52 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3749 2024-03-16 09:52 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 75756 2024-03-16 09:52 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1814 2024-03-16 09:52 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2024-03-16 09:52 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2024-03-16 09:52 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2024-03-16 09:52 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2024-03-16 09:52 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2024-03-16 09:52 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2024-03-16 09:52 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2024-03-16 09:52 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 3273 2024-03-16 09:52 share/doc/nerdctl/docs/gpu.md
drwxr-xr-x 0/0 0 2024-03-16 09:52 share/doc/nerdctl/docs/images/
-rw-r--r-- 0/0 684421 2024-03-16 09:52 share/doc/nerdctl/docs/images/rootlessKit-network-design.png
-rw-r--r-- 0/0 14462 2024-03-16 09:52 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2024-03-16 09:52 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2960 2024-03-16 09:52 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2024-03-16 09:52 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2024-03-16 09:52 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2024-03-16 09:52 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2024-03-16 09:52 ...
v1.7.5
Changes
- nerdctl-full: update containerd (1.7.14), slirp4netns (1.2.3), CNI plugins (1.4.1), RootlessKit (2.0.2), Kubo (0.27.0), imgcrypt (1.1.10) (#2885)
Full changes: https://github.com/containerd/nerdctl/milestone/41?closed=1
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-1.7.5-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-1.7.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-1.7.5-linux-amd64.tar.gz
-rwxr-xr-x root/root 25108480 2024-03-16 09:28 nerdctl
-rwxr-xr-x root/root 21916 2024-03-16 09:27 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 7187 2024-03-16 09:27 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-1.7.5-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2024-03-16 09:35 bin/
-rwxr-xr-x 0/0 27644700 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0 53374823 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 7277848 2024-03-16 09:32 bin/bypass4netns
-rwxr-xr-x 0/0 5308416 2024-03-16 09:32 bin/bypass4netnsd
-rwxr-xr-x 0/0 38885048 2024-03-16 09:34 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 21916 2024-03-16 09:33 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 7187 2024-03-16 09:33 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2024-03-16 09:34 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20634681 2024-03-16 09:34 bin/ctd-decoder
-rwxr-xr-x 0/0 18771968 2024-03-16 09:33 bin/ctr
-rwxr-xr-x 0/0 29669401 2024-03-16 09:34 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2024-03-16 09:34 bin/fuse-overlayfs
-rwxr-xr-x 0/0 65588315 2024-03-16 09:34 bin/ipfs
-rwxr-xr-x 0/0 25079808 2024-03-16 09:33 bin/nerdctl
-rwxr-xr-x 0/0 10666181 2024-03-05 22:20 bin/rootlessctl
-rwxr-xr-x 0/0 12358373 2024-03-05 22:20 bin/rootlesskit
-rwxr-xr-x 0/0 15074064 2024-03-16 09:33 bin/runc
-rwxr-xr-x 0/0 2346328 2024-03-16 09:34 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2024-03-16 09:34 bin/tini
drwxr-xr-x 0/0 0 2024-03-16 09:34 lib/
drwxr-xr-x 0/0 0 2024-03-16 09:34 lib/systemd/
drwxr-xr-x 0/0 0 2024-03-16 09:34 lib/systemd/system/
-rw-r--r-- 0/0 1475 2024-03-16 09:34 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2024-03-16 09:32 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2024-03-16 09:34 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2024-03-16 09:34 libexec/
drwxr-xr-x 0/0 0 2024-03-16 09:34 libexec/cni/
-rw-r--r-- 0/0 11357 2024-03-12 10:56 libexec/cni/LICENSE
-rw-r--r-- 0/0 2343 2024-03-12 10:56 libexec/cni/README.md
-rwxr-xr-x 0/0 4119661 2024-03-12 10:56 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4662227 2024-03-12 10:56 libexec/cni/bridge
-rwxr-xr-x 0/0 11065251 2024-03-12 10:56 libexec/cni/dhcp
-rwxr-xr-x 0/0 4306546 2024-03-12 10:56 libexec/cni/dummy
-rwxr-xr-x 0/0 4751593 2024-03-12 10:56 libexec/cni/firewall
-rwxr-xr-x 0/0 4198427 2024-03-12 10:56 libexec/cni/host-device
-rwxr-xr-x 0/0 3560496 2024-03-12 10:56 libexec/cni/host-local
-rwxr-xr-x 0/0 4324636 2024-03-12 10:56 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3651038 2024-03-12 10:56 libexec/cni/loopback
-rwxr-xr-x 0/0 4355073 2024-03-12 10:56 libexec/cni/macvlan
-rwxr-xr-x 0/0 4095898 2024-03-12 10:56 libexec/cni/portmap
-rwxr-xr-x 0/0 4476535 2024-03-12 10:56 libexec/cni/ptp
-rwxr-xr-x 0/0 3861176 2024-03-12 10:56 libexec/cni/sbr
-rwxr-xr-x 0/0 3120090 2024-03-12 10:56 libexec/cni/static
-rwxr-xr-x 0/0 4381887 2024-03-12 10:56 libexec/cni/tap
-rwxr-xr-x 0/0 3743844 2024-03-12 10:56 libexec/cni/tuning
-rwxr-xr-x 0/0 4319235 2024-03-12 10:56 libexec/cni/vlan
-rwxr-xr-x 0/0 4008392 2024-03-12 10:56 libexec/cni/vrf
drwxr-xr-x 0/0 0 2024-03-16 09:33 share/
drwxr-xr-x 0/0 0 2024-03-16 09:33 share/doc/
drwxr-xr-x 0/0 0 2024-03-16 09:33 share/doc/nerdctl/
-rw-r--r-- 0/0 12480 2024-03-16 09:27 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2024-03-16 09:27 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2024-03-16 09:27 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2024-03-16 09:27 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2024-03-16 09:27 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 74383 2024-03-16 09:27 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1814 2024-03-16 09:27 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2024-03-16 09:27 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2024-03-16 09:27 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2024-03-16 09:27 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2024-03-16 09:27 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2024-03-16 09:27 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2024-03-16 09:27 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2024-03-16 09:27 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 3228 2024-03-16 09:27 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2024-03-16 09:27 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2024-03-16 09:27 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2960 2024-03-16 09:27 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2024-03-16 09:27 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2024-03-16 09:27 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2024-03-16 09:27 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2024-03-16 09:27 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 5088 2024-03-16 09:27 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2024-03-16 09:27 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2024-03-16 09:27 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2024-03-16 09:35 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1154 2024-03-16 09:35 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 6578 2024-03-16 09:35 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v1.7.5
- containerd: v1.7.14
- runc: v1.1.12
- CNI plugins: v1.4.1
- BuildKit: v0.12.5
- Stargz Snapshotter: v0.15.1
- imgcrypt: v1.1.10
- RootlessKit: v2.0.2
- slirp4netns: v1.2.3
- bypass4netns: v0.4.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.8
- Kubo (IPFS): v0.27.0
- Tini: v0.19.0
- buildg: v0.4.1
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.3/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.27.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
Quick start
Rootful
$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine
Rootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine
Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .
The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/8306824666
The sha256sum of the SHA256SUMS file itself is 9bf01c4843b3d90eddac5cd0e43dc901bf0f55f1b60a77ceace19db854935106
.
Release manager: Akihiro Suda (@AkihiroSuda)
v2.0.0-beta.1
Changes
nerdctl v2 enables "detach-netns" for Rootless mode by default (#2723).
This will bring:
- Faster and more stable
nerdctl pull
,nerdctl push
,nerdctl build
, etc - Proper support for
nerdctl pull 127.0.0.1:.../...
- Proper support for
nerdctl run --net=host
Depends on RootlessKit v2 and BuildKit v0.13 (included in nerdctl-full-*.tar.gz
).
Note
After upgrading nerdctl (rootless mode) from v1.x to v2.x, it is highly recommended to
re-install the systemd units and the configurations:
containerd-rootless-setuptool.sh uninstall
rm -rf ~/.config/{nerdctl,buildkit}
containerd-rootless-setuptool.sh install
CONTAINERD_NAMESPACE=default containerd-rootless-setuptool.sh install-buildkit-containerd
Other major changes:
nerdctl run
:- Add
--systemd
flag for running systemd in containers flag (#2785, thanks to @sazzy4o) - Add
--ipc=(shareable|container:<container>)
flag (#2757, thanks to @minuk-dev)
- Add
nerdctl build
:
Full changes: https://github.com/containerd/nerdctl/milestone/37?closed=1
Thanks to @fahedouch @manugupt1 @minuk-dev @monirul @roman-kiselenko @sazzy4o @yankay @zwpaper
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-2.0.0-beta.1-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-2.0.0-beta.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.0.0-beta.1-linux-amd64.tar.gz
-rwxr-xr-x root/root 25071616 2024-02-19 07:16 nerdctl
-rwxr-xr-x root/root 22764 2024-02-19 07:16 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 8640 2024-02-19 07:16 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-2.0.0-beta.1-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2024-02-19 07:23 bin/
-rwxr-xr-x 0/0 29671808 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0 57170042 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 7277816 2024-02-19 07:21 bin/bypass4netns
-rwxr-xr-x 0/0 5308416 2024-02-19 07:21 bin/bypass4netnsd
-rwxr-xr-x 0/0 38864536 2024-02-19 07:23 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 22764 2024-02-19 07:22 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 8640 2024-02-19 07:22 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2024-02-19 07:23 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20495865 2024-02-19 07:23 bin/ctd-decoder
-rwxr-xr-x 0/0 18763776 2024-02-19 07:22 bin/ctr
-rwxr-xr-x 0/0 29446171 2024-02-19 07:23 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2024-02-19 07:23 bin/fuse-overlayfs
-rwxr-xr-x 0/0 65347946 2024-02-19 07:23 bin/ipfs
-rwxr-xr-x 0/0 25042944 2024-02-19 07:22 bin/nerdctl
-rwxr-xr-x 0/0 10128131 2024-02-06 02:44 bin/rootlessctl
-rwxr-xr-x 0/0 11774347 2024-02-06 02:44 bin/rootlesskit
-rwxr-xr-x 0/0 15074072 2024-02-19 07:22 bin/runc
-rwxr-xr-x 0/0 2346328 2024-02-19 07:23 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2024-02-19 07:23 bin/tini
drwxr-xr-x 0/0 0 2024-02-19 07:23 lib/
drwxr-xr-x 0/0 0 2024-02-19 07:23 lib/systemd/
drwxr-xr-x 0/0 0 2024-02-19 07:23 lib/systemd/system/
-rw-r--r-- 0/0 1475 2024-02-19 07:23 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2024-02-19 07:21 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2024-02-19 07:23 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2024-02-19 07:23 libexec/
drwxrwxr-x 0/0 0 2024-02-19 07:23 libexec/cni/
-rwxr-xr-x 0/0 4109351 2023-12-04 16:38 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4652757 2023-12-04 16:39 libexec/cni/bridge
-rwxr-xr-x 0/0 11050013 2023-12-04 16:39 libexec/cni/dhcp
-rwxr-xr-x 0/0 4297556 2023-12-04 16:39 libexec/cni/dummy
-rwxr-xr-x 0/0 4736299 2023-12-04 16:39 libexec/cni/firewall
-rwxr-xr-x 0/0 4191837 2023-12-04 16:39 libexec/cni/host-device
-rwxr-xr-x 0/0 3549866 2023-12-04 16:39 libexec/cni/host-local
-rwxr-xr-x 0/0 4315686 2023-12-04 16:39 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3636792 2023-12-04 16:39 libexec/cni/loopback
-rwxr-xr-x 0/0 4349395 2023-12-04 16:39 libexec/cni/macvlan
-rwxr-xr-x 0/0 4085020 2023-12-04 16:39 libexec/cni/portmap
-rwxr-xr-x 0/0 4470977 2023-12-04 16:39 libexec/cni/ptp
-rwxr-xr-x 0/0 3851218 2023-12-04 16:39 libexec/cni/sbr
-rwxr-xr-x 0/0 3110828 2023-12-04 16:39 libexec/cni/static
-rwxr-xr-x 0/0 4371897 2023-12-04 16:39 libexec/cni/tap
-rwxr-xr-x 0/0 3726382 2023-12-04 16:39 libexec/cni/tuning
-rwxr-xr-x 0/0 4310173 2023-12-04 16:39 libexec/cni/vlan
-rwxr-xr-x 0/0 4001842 2023-12-04 16:39 libexec/cni/vrf
drwxr-xr-x 0/0 0 2024-02-19 07:22 share/
drwxr-xr-x 0/0 0 2024-02-19 07:22 share/doc/
drwxr-xr-x 0/0 0 2024-02-19 07:22 share/doc/nerdctl/
-rw-r--r-- 0/0 12390 2024-02-19 07:16 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2024-02-19 07:16 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2024-02-19 07:16 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2024-02-19 07:16 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3749 2024-02-19 07:16 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 75459 2024-02-19 07:16 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1814 2024-02-19 07:16 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2024-02-19 07:16 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2024-02-19 07:16 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2024-02-19 07:16 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2024-02-19 07:16 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2024-02-19 07:16 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2024-02-19 07:16 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2024-02-19 07:16 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 3273 2024-02-19 07:16 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2024-02-19 07:16 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2024-02-19 07:16 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2960 2024-02-19 07:16 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2024-02-19 07:16 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2024-02-19 07:16 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2024-02-19 07:16 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2024-02-19 07:16 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 7276 2024-02-19 07:16 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2024-02-19 07:16 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2024-02-19 07:16 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2024-02-19 07:23 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1164 2024-02-19 07:23 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 8057 2024-02-19 07:23 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- ner...
v1.7.4
Changes
-
rootless:
- Fix incompatibility with firewalld (
Not Authorized(uid): org.fedoraproject.FirewallD1.config
) (#2822)
- Fix incompatibility with firewalld (
-
nerdctl-full:
- Update RootlessKit (2.0.1) (#2800)
Full changes: https://github.com/containerd/nerdctl/milestone/40?closed=1
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-1.7.4-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-1.7.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-1.7.4-linux-amd64.tar.gz
-rwxr-xr-x root/root 25010176 2024-02-19 07:16 nerdctl
-rwxr-xr-x root/root 21916 2024-02-19 07:15 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 7187 2024-02-19 07:15 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-1.7.4-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2024-02-19 07:23 bin/
-rwxr-xr-x 0/0 27644700 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0 53374823 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 7277816 2024-02-19 07:21 bin/bypass4netns
-rwxr-xr-x 0/0 5308416 2024-02-19 07:21 bin/bypass4netnsd
-rwxr-xr-x 0/0 38864536 2024-02-19 07:22 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 21916 2024-02-19 07:21 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 7187 2024-02-19 07:21 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2024-02-19 07:22 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20495889 2024-02-19 07:23 bin/ctd-decoder
-rwxr-xr-x 0/0 18763776 2024-02-19 07:22 bin/ctr
-rwxr-xr-x 0/0 29446195 2024-02-19 07:23 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2024-02-19 07:23 bin/fuse-overlayfs
-rwxr-xr-x 0/0 65347946 2024-02-19 07:22 bin/ipfs
-rwxr-xr-x 0/0 24981504 2024-02-19 07:21 bin/nerdctl
-rwxr-xr-x 0/0 10128131 2024-02-06 02:44 bin/rootlessctl
-rwxr-xr-x 0/0 11774347 2024-02-06 02:44 bin/rootlesskit
-rwxr-xr-x 0/0 15074072 2024-02-19 07:21 bin/runc
-rwxr-xr-x 0/0 2346328 2024-02-19 07:23 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2024-02-19 07:23 bin/tini
drwxr-xr-x 0/0 0 2024-02-19 07:22 lib/
drwxr-xr-x 0/0 0 2024-02-19 07:22 lib/systemd/
drwxr-xr-x 0/0 0 2024-02-19 07:23 lib/systemd/system/
-rw-r--r-- 0/0 1475 2024-02-19 07:23 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2024-02-19 07:20 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2024-02-19 07:23 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2024-02-19 07:22 libexec/
drwxrwxr-x 0/0 0 2024-02-19 07:22 libexec/cni/
-rwxr-xr-x 0/0 4109351 2023-12-04 16:38 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4652757 2023-12-04 16:39 libexec/cni/bridge
-rwxr-xr-x 0/0 11050013 2023-12-04 16:39 libexec/cni/dhcp
-rwxr-xr-x 0/0 4297556 2023-12-04 16:39 libexec/cni/dummy
-rwxr-xr-x 0/0 4736299 2023-12-04 16:39 libexec/cni/firewall
-rwxr-xr-x 0/0 4191837 2023-12-04 16:39 libexec/cni/host-device
-rwxr-xr-x 0/0 3549866 2023-12-04 16:39 libexec/cni/host-local
-rwxr-xr-x 0/0 4315686 2023-12-04 16:39 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3636792 2023-12-04 16:39 libexec/cni/loopback
-rwxr-xr-x 0/0 4349395 2023-12-04 16:39 libexec/cni/macvlan
-rwxr-xr-x 0/0 4085020 2023-12-04 16:39 libexec/cni/portmap
-rwxr-xr-x 0/0 4470977 2023-12-04 16:39 libexec/cni/ptp
-rwxr-xr-x 0/0 3851218 2023-12-04 16:39 libexec/cni/sbr
-rwxr-xr-x 0/0 3110828 2023-12-04 16:39 libexec/cni/static
-rwxr-xr-x 0/0 4371897 2023-12-04 16:39 libexec/cni/tap
-rwxr-xr-x 0/0 3726382 2023-12-04 16:39 libexec/cni/tuning
-rwxr-xr-x 0/0 4310173 2023-12-04 16:39 libexec/cni/vlan
-rwxr-xr-x 0/0 4001842 2023-12-04 16:39 libexec/cni/vrf
drwxr-xr-x 0/0 0 2024-02-19 07:21 share/
drwxr-xr-x 0/0 0 2024-02-19 07:21 share/doc/
drwxr-xr-x 0/0 0 2024-02-19 07:21 share/doc/nerdctl/
-rw-r--r-- 0/0 12480 2024-02-19 07:15 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2024-02-19 07:15 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2024-02-19 07:15 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2024-02-19 07:15 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2024-02-19 07:15 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 74383 2024-02-19 07:15 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1814 2024-02-19 07:15 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2024-02-19 07:15 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2024-02-19 07:15 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2024-02-19 07:15 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2024-02-19 07:15 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2024-02-19 07:15 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2024-02-19 07:15 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2024-02-19 07:15 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 3228 2024-02-19 07:15 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2024-02-19 07:15 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2024-02-19 07:15 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2960 2024-02-19 07:15 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2024-02-19 07:15 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2024-02-19 07:15 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2024-02-19 07:15 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2024-02-19 07:15 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 5088 2024-02-19 07:15 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2024-02-19 07:15 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2024-02-19 07:15 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2024-02-19 07:23 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1153 2024-02-19 07:23 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 6400 2024-02-19 07:23 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v1.7.4
- containerd: v1.7.13
- runc: v1.1.12
- CNI plugins: v1.4.0
- BuildKit: v0.12.5
- Stargz Snapshotter: v0.15.1
- imgcrypt: v1.1.9
- RootlessKit: v2.0.1
- slirp4netns: v1.2.2
- bypass4netns: v0.4.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.8
- Kubo (IPFS): v0.26.0
- Tini: v0.19.0
- buildg: v0.4.1
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.2/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.26.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
Quick start
Rootful
$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine
Rootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine
Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .
The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/7955891276
The sha256sum of the SHA256SUMS file itself is 94f417a37a8c2a48b5f60e1109aeb5ec47295c4727e44badc759c060871ac952
.
Release manager: Akihiro Suda (@AkihiroSuda)
v2.0.0-beta.0
Changes
nerdctl v2 enables "detach-netns" for Rootless mode by default (#2723).
This will bring:
- Faster and more stable
nerdctl pull
,nerdctl push
,nerdctl build
, etc - Proper support for
nerdctl pull 127.0.0.1:.../...
- Proper support for
nerdctl run --net=host
Depends on RootlessKit v2 and BuildKit v0.13 (included in nerdctl-full-*.tar.gz
).
Note
After upgrading nerdctl (rootless mode) from v1.x to v2.x, it is highly recommended to
re-install the systemd units and the configurations:
containerd-rootless-setuptool.sh uninstall
rm -rf ~/.config/{nerdctl,buildkit}
containerd-rootless-setuptool.sh install
CONTAINERD_NAMESPACE=default containerd-rootless-setuptool.sh install-buildkit-containerd
Full changes: https://github.com/containerd/nerdctl/milestone/37?closed=1
Thanks to @fahedouch @manugupt1 @yankay
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-2.0.0-beta.0-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-2.0.0-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.0.0-beta.0-linux-amd64.tar.gz
-rwxr-xr-x root/root 25042944 2024-02-01 07:00 nerdctl
-rwxr-xr-x root/root 22487 2024-02-01 06:59 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 8640 2024-02-01 06:59 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-2.0.0-beta.0-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2024-02-01 07:07 bin/
-rwxr-xr-x 0/0 29458639 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0 0 2024-02-01 07:07 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0 57094151 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 7277720 2024-02-01 07:05 bin/bypass4netns
-rwxr-xr-x 0/0 5308416 2024-02-01 07:05 bin/bypass4netnsd
-rwxr-xr-x 0/0 38864440 2024-02-01 07:06 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 22487 2024-02-01 07:05 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 8640 2024-02-01 07:05 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2024-02-01 07:06 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20496031 2024-02-01 07:07 bin/ctd-decoder
-rwxr-xr-x 0/0 18763776 2024-02-01 07:06 bin/ctr
-rwxr-xr-x 0/0 29449409 2024-02-01 07:07 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2024-02-01 07:07 bin/fuse-overlayfs
-rwxr-xr-x 0/0 65332928 2024-02-01 07:06 bin/ipfs
-rwxr-xr-x 0/0 25014272 2024-02-01 07:05 bin/nerdctl
-rwxr-xr-x 0/0 10128131 2024-01-15 01:11 bin/rootlessctl
-rwxr-xr-x 0/0 11771211 2024-01-15 01:11 bin/rootlesskit
-rwxr-xr-x 0/0 15065104 2024-02-01 07:05 bin/runc
-rwxr-xr-x 0/0 2346328 2024-02-01 07:07 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2024-02-01 07:07 bin/tini
drwxr-xr-x 0/0 0 2024-02-01 07:07 lib/
drwxr-xr-x 0/0 0 2024-02-01 07:07 lib/systemd/
drwxr-xr-x 0/0 0 2024-02-01 07:07 lib/systemd/system/
-rw-r--r-- 0/0 1475 2024-02-01 07:07 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2024-02-01 07:04 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2024-02-01 07:07 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2024-02-01 07:07 libexec/
drwxrwxr-x 0/0 0 2024-02-01 07:07 libexec/cni/
-rwxr-xr-x 0/0 4109351 2023-12-04 16:38 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4652757 2023-12-04 16:39 libexec/cni/bridge
-rwxr-xr-x 0/0 11050013 2023-12-04 16:39 libexec/cni/dhcp
-rwxr-xr-x 0/0 4297556 2023-12-04 16:39 libexec/cni/dummy
-rwxr-xr-x 0/0 4736299 2023-12-04 16:39 libexec/cni/firewall
-rwxr-xr-x 0/0 4191837 2023-12-04 16:39 libexec/cni/host-device
-rwxr-xr-x 0/0 3549866 2023-12-04 16:39 libexec/cni/host-local
-rwxr-xr-x 0/0 4315686 2023-12-04 16:39 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3636792 2023-12-04 16:39 libexec/cni/loopback
-rwxr-xr-x 0/0 4349395 2023-12-04 16:39 libexec/cni/macvlan
-rwxr-xr-x 0/0 4085020 2023-12-04 16:39 libexec/cni/portmap
-rwxr-xr-x 0/0 4470977 2023-12-04 16:39 libexec/cni/ptp
-rwxr-xr-x 0/0 3851218 2023-12-04 16:39 libexec/cni/sbr
-rwxr-xr-x 0/0 3110828 2023-12-04 16:39 libexec/cni/static
-rwxr-xr-x 0/0 4371897 2023-12-04 16:39 libexec/cni/tap
-rwxr-xr-x 0/0 3726382 2023-12-04 16:39 libexec/cni/tuning
-rwxr-xr-x 0/0 4310173 2023-12-04 16:39 libexec/cni/vlan
-rwxr-xr-x 0/0 4001842 2023-12-04 16:39 libexec/cni/vrf
drwxr-xr-x 0/0 0 2024-02-01 07:05 share/
drwxr-xr-x 0/0 0 2024-02-01 07:05 share/doc/
drwxr-xr-x 0/0 0 2024-02-01 07:05 share/doc/nerdctl/
-rw-r--r-- 0/0 12482 2024-02-01 06:59 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2024-02-01 06:59 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2024-02-01 06:59 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2024-02-01 06:59 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2024-02-01 06:59 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 74383 2024-02-01 06:59 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1814 2024-02-01 06:59 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2024-02-01 06:59 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2024-02-01 06:59 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2024-02-01 06:59 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2024-02-01 06:59 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2024-02-01 06:59 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2024-02-01 06:59 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2024-02-01 06:59 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 3273 2024-02-01 06:59 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2024-02-01 06:59 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2024-02-01 06:59 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2960 2024-02-01 06:59 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2024-02-01 06:59 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2024-02-01 06:59 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2024-02-01 06:59 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2024-02-01 06:59 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 7276 2024-02-01 06:59 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2024-02-01 06:59 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2024-02-01 06:59 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2024-02-01 07:07 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1166 2024-02-01 07:07 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 8057 2024-02-01 07:07 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v2.0.0-beta.0
- containerd: v1.7.13
- runc: v1.1.12
- CNI plugins: v1.4.0
- BuildKit: v0.13.0-beta3
- Stargz Snapshotter: v0.15.1
- imgcrypt: v1.1.9
- RootlessKit: v2.0.0
- slirp4netns: v1.2.2
- bypass4netns: v0.4.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.8
- Kubo (IPFS): v0.26.0
- Tini: v0.19.0
- buildg: v0.4.1
## License
- bin/slirp...
v1.7.3
This release updates the runc and BuildKit binaries included in the nerdctl-full-*.tar.gz
artifacts to apply security fixes.
Changes
-
nerdctl run
:- Update seccomp profile for kernel 6.7 (#2782)
-
nerdctl build
: -
nerdctl logs
: -
nerdctl compose
:- Implement
group-add
(#2771, thanks to @yankay)
- Implement
-
containerd-rootless-setuptool.sh
:nsenter
: inherit RootlessKit env (#2743)
-
nerdctl-full
:- Update RootlessKit to v2.0.0 (#2779)
- Update containerd to v1.7.13 (#2779)
- Update runc to v1.1.12 (fixes CVE-2024-21626) (#2779)
- Update bypass4netns to v0.4.0 (#2779)
- Update Kubo to v0.26.0 (#2779)
- Update BuildKit to v0.12.5 (fixes CVE-2024-23651, CVE-2024-23652, CVE-2024-23653, CVE-2024-23650) (#2779)
Full changes: https://github.com/containerd/nerdctl/milestone/39?closed=1
Thanks to @TinaMor @dimaqq @henry118 @miurahr @sondavidb @vsiravar @yankay @zjumoon01
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-1.7.3-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-1.7.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-1.7.3-linux-amd64.tar.gz
-rwxr-xr-x root/root 25006080 2024-01-31 23:29 nerdctl
-rwxr-xr-x root/root 21916 2024-01-31 23:29 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 7187 2024-01-31 23:29 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-1.7.3-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2024-01-31 23:36 bin/
-rwxr-xr-x 0/0 27644700 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0 53374823 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 7277720 2024-01-31 23:34 bin/bypass4netns
-rwxr-xr-x 0/0 5308416 2024-01-31 23:34 bin/bypass4netnsd
-rwxr-xr-x 0/0 38864440 2024-01-31 23:36 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 21916 2024-01-31 23:34 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 7187 2024-01-31 23:34 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2024-01-31 23:36 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20496015 2024-01-31 23:36 bin/ctd-decoder
-rwxr-xr-x 0/0 18763776 2024-01-31 23:35 bin/ctr
-rwxr-xr-x 0/0 29449409 2024-01-31 23:36 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2024-01-31 23:36 bin/fuse-overlayfs
-rwxr-xr-x 0/0 65332928 2024-01-31 23:36 bin/ipfs
-rwxr-xr-x 0/0 24977408 2024-01-31 23:34 bin/nerdctl
-rwxr-xr-x 0/0 10128131 2024-01-15 01:11 bin/rootlessctl
-rwxr-xr-x 0/0 11771211 2024-01-15 01:11 bin/rootlesskit
-rwxr-xr-x 0/0 15065104 2024-01-31 23:34 bin/runc
-rwxr-xr-x 0/0 2346328 2024-01-31 23:36 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2024-01-31 23:36 bin/tini
drwxr-xr-x 0/0 0 2024-01-31 23:36 lib/
drwxr-xr-x 0/0 0 2024-01-31 23:36 lib/systemd/
drwxr-xr-x 0/0 0 2024-01-31 23:36 lib/systemd/system/
-rw-r--r-- 0/0 1475 2024-01-31 23:36 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2024-01-31 23:34 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2024-01-31 23:36 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2024-01-31 23:36 libexec/
drwxrwxr-x 0/0 0 2024-01-31 23:36 libexec/cni/
-rwxr-xr-x 0/0 4109351 2023-12-04 16:38 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4652757 2023-12-04 16:39 libexec/cni/bridge
-rwxr-xr-x 0/0 11050013 2023-12-04 16:39 libexec/cni/dhcp
-rwxr-xr-x 0/0 4297556 2023-12-04 16:39 libexec/cni/dummy
-rwxr-xr-x 0/0 4736299 2023-12-04 16:39 libexec/cni/firewall
-rwxr-xr-x 0/0 4191837 2023-12-04 16:39 libexec/cni/host-device
-rwxr-xr-x 0/0 3549866 2023-12-04 16:39 libexec/cni/host-local
-rwxr-xr-x 0/0 4315686 2023-12-04 16:39 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3636792 2023-12-04 16:39 libexec/cni/loopback
-rwxr-xr-x 0/0 4349395 2023-12-04 16:39 libexec/cni/macvlan
-rwxr-xr-x 0/0 4085020 2023-12-04 16:39 libexec/cni/portmap
-rwxr-xr-x 0/0 4470977 2023-12-04 16:39 libexec/cni/ptp
-rwxr-xr-x 0/0 3851218 2023-12-04 16:39 libexec/cni/sbr
-rwxr-xr-x 0/0 3110828 2023-12-04 16:39 libexec/cni/static
-rwxr-xr-x 0/0 4371897 2023-12-04 16:39 libexec/cni/tap
-rwxr-xr-x 0/0 3726382 2023-12-04 16:39 libexec/cni/tuning
-rwxr-xr-x 0/0 4310173 2023-12-04 16:39 libexec/cni/vlan
-rwxr-xr-x 0/0 4001842 2023-12-04 16:39 libexec/cni/vrf
drwxr-xr-x 0/0 0 2024-01-31 23:34 share/
drwxr-xr-x 0/0 0 2024-01-31 23:34 share/doc/
drwxr-xr-x 0/0 0 2024-01-31 23:34 share/doc/nerdctl/
-rw-r--r-- 0/0 12480 2024-01-31 23:29 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2024-01-31 23:29 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2024-01-31 23:29 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2024-01-31 23:29 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2024-01-31 23:29 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 74383 2024-01-31 23:29 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1814 2024-01-31 23:29 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2024-01-31 23:29 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2024-01-31 23:29 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2024-01-31 23:29 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2024-01-31 23:29 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2024-01-31 23:29 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2024-01-31 23:29 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2024-01-31 23:29 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 3228 2024-01-31 23:29 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2024-01-31 23:29 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2024-01-31 23:29 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2960 2024-01-31 23:29 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2024-01-31 23:29 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2024-01-31 23:29 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2024-01-31 23:29 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2024-01-31 23:29 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 5088 2024-01-31 23:29 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2024-01-31 23:29 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2024-01-31 23:29 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2024-01-31 23:36 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1153 2024-01-31 23:36 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 6400 2024-01-31 23:36 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v1.7.3
- containerd: v1.7.13
- runc: v1.1.12
- CNI plugins: v1.4.0
- BuildKit: v0.12.5
- Stargz Snapshotter: v0.15.1
- imgcrypt: v1.1.9
- RootlessKit: v2.0.0
- slirp4netns: v1.2.2
- bypass4netns: v0.4.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.8
- Kubo (IPFS): v0.26.0
- Tini: v0.19.0
- buildg: v0.4.1
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.2/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.26.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
Quick start
Rootful
$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine
Rootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine
Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .
The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/7733769295
The sha256sum of the SHA256SUMS file itself is 9954c172f202e8fbebc733e1a58d3aeaed05ca5372c416342d6ebd06859f0411
.
Release manager: Akihiro Suda (@AkihiroSuda)
v1.7.2
Changes
nerdctl run
:- Reset the default value of ulimit (#2682, thanks to @jiusanzhou)
- Dedup mounts for
/etc/hosts
/etc/resolv.conf
(#2686, thanks to @yankay)
nerdctl-full
:
Full changes: https://github.com/containerd/nerdctl/milestone/36?closed=1
Thanks to @jiusanzhou @yankay
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-1.7.2-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-1.7.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-1.7.2-linux-amd64.tar.gz
-rwxr-xr-x root/root 24838144 2023-12-12 11:00 nerdctl
-rwxr-xr-x root/root 21618 2023-12-12 10:59 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 7187 2023-12-12 10:59 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-1.7.2-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2023-12-12 11:06 bin/
-rwxr-xr-x 0/0 27639988 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0 53332813 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 3784248 2023-12-12 11:04 bin/bypass4netns
-rwxr-xr-x 0/0 5279744 2023-12-12 11:04 bin/bypass4netnsd
-rwxr-xr-x 0/0 38848024 2023-12-12 11:06 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 21618 2023-12-12 11:05 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 7187 2023-12-12 11:05 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2023-12-12 11:06 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20495868 2023-12-12 11:06 bin/ctd-decoder
-rwxr-xr-x 0/0 18755584 2023-12-12 11:05 bin/ctr
-rwxr-xr-x 0/0 29455670 2023-12-12 11:06 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2023-12-12 11:06 bin/fuse-overlayfs
-rwxr-xr-x 0/0 68883475 2023-12-12 11:06 bin/ipfs
-rwxr-xr-x 0/0 24809472 2023-12-12 11:05 bin/nerdctl
-rwxr-xr-x 0/0 10113536 2023-05-30 06:31 bin/rootlessctl
-rwxr-xr-x 0/0 11600435 2023-05-30 06:31 bin/rootlesskit
-rwxr-xr-x 0/0 15024600 2023-12-12 11:05 bin/runc
-rwxr-xr-x 0/0 2346328 2023-12-12 11:06 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2023-12-12 11:06 bin/tini
drwxr-xr-x 0/0 0 2023-12-12 11:06 lib/
drwxr-xr-x 0/0 0 2023-12-12 11:06 lib/systemd/
drwxr-xr-x 0/0 0 2023-12-12 11:06 lib/systemd/system/
-rw-r--r-- 0/0 1475 2023-12-12 11:06 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2023-12-12 11:04 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2023-12-12 11:06 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2023-12-12 11:06 libexec/
drwxrwxr-x 0/0 0 2023-12-12 11:06 libexec/cni/
-rwxr-xr-x 0/0 4109351 2023-12-04 16:38 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4652757 2023-12-04 16:39 libexec/cni/bridge
-rwxr-xr-x 0/0 11050013 2023-12-04 16:39 libexec/cni/dhcp
-rwxr-xr-x 0/0 4297556 2023-12-04 16:39 libexec/cni/dummy
-rwxr-xr-x 0/0 4736299 2023-12-04 16:39 libexec/cni/firewall
-rwxr-xr-x 0/0 4191837 2023-12-04 16:39 libexec/cni/host-device
-rwxr-xr-x 0/0 3549866 2023-12-04 16:39 libexec/cni/host-local
-rwxr-xr-x 0/0 4315686 2023-12-04 16:39 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3636792 2023-12-04 16:39 libexec/cni/loopback
-rwxr-xr-x 0/0 4349395 2023-12-04 16:39 libexec/cni/macvlan
-rwxr-xr-x 0/0 4085020 2023-12-04 16:39 libexec/cni/portmap
-rwxr-xr-x 0/0 4470977 2023-12-04 16:39 libexec/cni/ptp
-rwxr-xr-x 0/0 3851218 2023-12-04 16:39 libexec/cni/sbr
-rwxr-xr-x 0/0 3110828 2023-12-04 16:39 libexec/cni/static
-rwxr-xr-x 0/0 4371897 2023-12-04 16:39 libexec/cni/tap
-rwxr-xr-x 0/0 3726382 2023-12-04 16:39 libexec/cni/tuning
-rwxr-xr-x 0/0 4310173 2023-12-04 16:39 libexec/cni/vlan
-rwxr-xr-x 0/0 4001842 2023-12-04 16:39 libexec/cni/vrf
drwxr-xr-x 0/0 0 2023-12-12 11:05 share/
drwxr-xr-x 0/0 0 2023-12-12 11:05 share/doc/
drwxr-xr-x 0/0 0 2023-12-12 11:05 share/doc/nerdctl/
-rw-r--r-- 0/0 12480 2023-12-12 10:59 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2023-12-12 10:59 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2023-12-12 10:59 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2023-12-12 10:59 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2023-12-12 10:59 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 74114 2023-12-12 10:59 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1846 2023-12-12 10:59 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2023-12-12 10:59 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2023-12-12 10:59 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2023-12-12 10:59 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2023-12-12 10:59 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2023-12-12 10:59 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2023-12-12 10:59 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2023-12-12 10:59 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 2439 2023-12-12 10:59 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2023-12-12 10:59 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2023-12-12 10:59 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2936 2023-12-12 10:59 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2023-12-12 10:59 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2023-12-12 10:59 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2023-12-12 10:59 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2023-12-12 10:59 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 5088 2023-12-12 10:59 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2023-12-12 10:59 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2023-12-12 10:59 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2023-12-12 11:07 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1153 2023-12-12 11:07 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 6400 2023-12-12 11:07 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v1.7.2
- containerd: v1.7.11
- runc: v1.1.10
- CNI plugins: v1.4.0
- BuildKit: v0.12.4
- Stargz Snapshotter: v0.15.1
- imgcrypt: v1.1.9
- RootlessKit: v1.1.1
- slirp4netns: v1.2.2
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.8
- Kubo (IPFS): v0.24.0
- Tini: v0.19.0
- buildg: v0.4.1
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.2/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.24.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
Quick start
Rootful
$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine
Rootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine
Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .
The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/7180471114
The sha256sum of the SHA256SUMS file itself is 6117f814475a955b1042e24c25870f539be1910e841cbb68e61a53eadb091608
.
Release manager: Akihiro Suda (@AkihiroSuda)
v1.7.1
Changes
-
nerdctl diff
:- Add
nerdctl diff
command (#2626, thanks to @minuk-dev)
- Add
-
nerdctl pull
:- Add
--soci-index-digest
flag to specify a particular index digest for SOCI (#2638, thanks to @sondavidb)
- Add
-
nerdctl compose exec
: -
nerdctl-full:
Full changes: https://github.com/containerd/nerdctl/milestone/33?closed=1
Thanks to @amrmahdi @kotoji @minuk-dev @sondavidb @suyanhanx @testwill @yanggangtony @yankay
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-1.7.1-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-1.7.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-1.7.1-linux-amd64.tar.gz
-rwxr-xr-x root/root 24805376 2023-11-30 08:13 nerdctl
-rwxr-xr-x root/root 21618 2023-11-30 08:13 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 7187 2023-11-30 08:13 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-1.7.1-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2023-11-30 08:20 bin/
-rwxr-xr-x 0/0 27639916 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0 53383522 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 3784248 2023-11-30 08:18 bin/bypass4netns
-rwxr-xr-x 0/0 5279744 2023-11-30 08:18 bin/bypass4netnsd
-rwxr-xr-x 0/0 38819192 2023-11-30 08:19 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 21618 2023-11-30 08:18 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 7187 2023-11-30 08:18 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2023-11-30 08:20 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20494228 2023-11-30 08:20 bin/ctd-decoder
-rwxr-xr-x 0/0 18726912 2023-11-30 08:19 bin/ctr
-rwxr-xr-x 0/0 29444894 2023-11-30 08:20 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2023-11-30 08:20 bin/fuse-overlayfs
-rwxr-xr-x 0/0 68890491 2023-11-30 08:19 bin/ipfs
-rwxr-xr-x 0/0 24776704 2023-11-30 08:18 bin/nerdctl
-rwxr-xr-x 0/0 10113536 2023-05-30 06:31 bin/rootlessctl
-rwxr-xr-x 0/0 11600435 2023-05-30 06:31 bin/rootlesskit
-rwxr-xr-x 0/0 15028088 2023-11-30 08:18 bin/runc
-rwxr-xr-x 0/0 2346328 2023-11-30 08:20 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2023-11-30 08:20 bin/tini
drwxr-xr-x 0/0 0 2023-11-30 08:20 lib/
drwxr-xr-x 0/0 0 2023-11-30 08:20 lib/systemd/
drwxr-xr-x 0/0 0 2023-11-30 08:20 lib/systemd/system/
-rw-r--r-- 0/0 1475 2023-11-30 08:20 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2023-11-30 08:17 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2023-11-30 08:20 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2023-11-30 08:20 libexec/
drwxrwxr-x 0/0 0 2023-11-30 08:20 libexec/cni/
-rwxr-xr-x 0/0 4016001 2023-05-09 19:53 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4531309 2023-05-09 19:53 libexec/cni/bridge
-rwxr-xr-x 0/0 10816051 2023-05-09 19:53 libexec/cni/dhcp
-rwxr-xr-x 0/0 4171248 2023-05-09 19:53 libexec/cni/dummy
-rwxr-xr-x 0/0 4649749 2023-05-09 19:53 libexec/cni/firewall
-rwxr-xr-x 0/0 4059321 2023-05-09 19:53 libexec/cni/host-device
-rwxr-xr-x 0/0 3444776 2023-05-09 19:53 libexec/cni/host-local
-rwxr-xr-x 0/0 4193323 2023-05-09 19:53 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3514598 2023-05-09 19:53 libexec/cni/loopback
-rwxr-xr-x 0/0 4227193 2023-05-09 19:53 libexec/cni/macvlan
-rwxr-xr-x 0/0 3955775 2023-05-09 19:53 libexec/cni/portmap
-rwxr-xr-x 0/0 4348835 2023-05-09 19:53 libexec/cni/ptp
-rwxr-xr-x 0/0 3716095 2023-05-09 19:53 libexec/cni/sbr
-rwxr-xr-x 0/0 2984504 2023-05-09 19:53 libexec/cni/static
-rwxr-xr-x 0/0 4258344 2023-05-09 19:53 libexec/cni/tap
-rwxr-xr-x 0/0 3603365 2023-05-09 19:53 libexec/cni/tuning
-rwxr-xr-x 0/0 4187498 2023-05-09 19:53 libexec/cni/vlan
-rwxr-xr-x 0/0 3754911 2023-05-09 19:53 libexec/cni/vrf
drwxr-xr-x 0/0 0 2023-11-30 08:18 share/
drwxr-xr-x 0/0 0 2023-11-30 08:18 share/doc/
drwxr-xr-x 0/0 0 2023-11-30 08:18 share/doc/nerdctl/
-rw-r--r-- 0/0 12480 2023-11-30 08:13 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2023-11-30 08:13 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2023-11-30 08:13 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2023-11-30 08:13 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2023-11-30 08:13 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 74114 2023-11-30 08:13 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1846 2023-11-30 08:13 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2023-11-30 08:13 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2023-11-30 08:13 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2023-11-30 08:13 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2023-11-30 08:13 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2023-11-30 08:13 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2023-11-30 08:13 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2023-11-30 08:13 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 2439 2023-11-30 08:13 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2023-11-30 08:13 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2023-11-30 08:13 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2936 2023-11-30 08:13 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2023-11-30 08:13 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2023-11-30 08:13 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2023-11-30 08:13 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2023-11-30 08:13 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 5088 2023-11-30 08:13 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2023-11-30 08:13 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2023-11-30 08:13 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2023-11-30 08:20 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1153 2023-11-30 08:20 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 6400 2023-11-30 08:20 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v1.7.1
- containerd: v1.7.10
- runc: v1.1.10
- CNI plugins: v1.3.0
- BuildKit: v0.12.3
- Stargz Snapshotter: v0.15.1
- imgcrypt: v1.1.9
- RootlessKit: v1.1.1
- slirp4netns: v1.2.2
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.8
- Kubo (IPFS): v0.24.0
- Tini: v0.19.0
- buildg: v0.4.1
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.2/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.24.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
Quick start
Rootful
$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine
Rootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine
Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .
The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/7043721428
The sha256sum of the SHA256SUMS file itself is bc360503d07dcafeb1e87d977017665d97de2c20219c8937cfb8a819a81f7ea8
.
Release manager: Akihiro Suda (@AkihiroSuda)
v1.7.0
Added the initial support for IPv6 (#1558) and CernVM-FS (#2599)
Changes
-
nerdctl network
: -
nerdctl run
:- Add the support for CernVM-FS snapshotter (#2599, thanks to @marcoverl)
- Implement
--network <ID>
(#2589, thanks to @fahedouch)
-
nerdctl ps
: -
nerdctl-full:
Full changes: https://github.com/containerd/nerdctl/milestone/35?closed=1
Thanks to @TinaMor @fahedouch @kotoji @ktock @marcoverl @ollypom @testwill @yankay @yuchanns
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-1.7.0-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-1.7.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-1.7.0-linux-amd64.tar.gz
-rwxr-xr-x root/root 24772608 2023-11-04 08:49 nerdctl
-rwxr-xr-x root/root 21618 2023-11-04 08:49 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 7187 2023-11-04 08:49 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-1.7.0-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2023-11-04 08:56 bin/
-rwxr-xr-x 0/0 27639916 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0 53383522 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 3788344 2023-11-04 08:54 bin/bypass4netns
-rwxr-xr-x 0/0 5283840 2023-11-04 08:54 bin/bypass4netnsd
-rwxr-xr-x 0/0 38607672 2023-11-04 08:56 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 21618 2023-11-04 08:55 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 7187 2023-11-04 08:55 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12075008 2023-11-04 08:56 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20506698 2023-11-04 08:56 bin/ctd-decoder
-rwxr-xr-x 0/0 18632704 2023-11-04 08:55 bin/ctr
-rwxr-xr-x 0/0 29484780 2023-11-04 08:56 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2023-11-04 08:56 bin/fuse-overlayfs
-rwxr-xr-x 0/0 63941548 2023-11-04 08:56 bin/ipfs
-rwxr-xr-x 0/0 24743936 2023-11-04 08:55 bin/nerdctl
-rwxr-xr-x 0/0 10113536 2023-05-30 06:31 bin/rootlessctl
-rwxr-xr-x 0/0 11600435 2023-05-30 06:31 bin/rootlesskit
-rwxr-xr-x 0/0 15043560 2023-11-04 08:54 bin/runc
-rwxr-xr-x 0/0 2346328 2023-11-04 08:56 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2023-11-04 08:56 bin/tini
drwxr-xr-x 0/0 0 2023-11-04 08:56 lib/
drwxr-xr-x 0/0 0 2023-11-04 08:56 lib/systemd/
drwxr-xr-x 0/0 0 2023-11-04 08:56 lib/systemd/system/
-rw-r--r-- 0/0 1475 2023-11-04 08:56 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2023-11-04 08:54 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2023-11-04 08:56 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2023-11-04 08:56 libexec/
drwxrwxr-x 0/0 0 2023-11-04 08:56 libexec/cni/
-rwxr-xr-x 0/0 4016001 2023-05-09 19:53 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4531309 2023-05-09 19:53 libexec/cni/bridge
-rwxr-xr-x 0/0 10816051 2023-05-09 19:53 libexec/cni/dhcp
-rwxr-xr-x 0/0 4171248 2023-05-09 19:53 libexec/cni/dummy
-rwxr-xr-x 0/0 4649749 2023-05-09 19:53 libexec/cni/firewall
-rwxr-xr-x 0/0 4059321 2023-05-09 19:53 libexec/cni/host-device
-rwxr-xr-x 0/0 3444776 2023-05-09 19:53 libexec/cni/host-local
-rwxr-xr-x 0/0 4193323 2023-05-09 19:53 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3514598 2023-05-09 19:53 libexec/cni/loopback
-rwxr-xr-x 0/0 4227193 2023-05-09 19:53 libexec/cni/macvlan
-rwxr-xr-x 0/0 3955775 2023-05-09 19:53 libexec/cni/portmap
-rwxr-xr-x 0/0 4348835 2023-05-09 19:53 libexec/cni/ptp
-rwxr-xr-x 0/0 3716095 2023-05-09 19:53 libexec/cni/sbr
-rwxr-xr-x 0/0 2984504 2023-05-09 19:53 libexec/cni/static
-rwxr-xr-x 0/0 4258344 2023-05-09 19:53 libexec/cni/tap
-rwxr-xr-x 0/0 3603365 2023-05-09 19:53 libexec/cni/tuning
-rwxr-xr-x 0/0 4187498 2023-05-09 19:53 libexec/cni/vlan
-rwxr-xr-x 0/0 3754911 2023-05-09 19:53 libexec/cni/vrf
drwxr-xr-x 0/0 0 2023-11-04 08:55 share/
drwxr-xr-x 0/0 0 2023-11-04 08:55 share/doc/
drwxr-xr-x 0/0 0 2023-11-04 08:55 share/doc/nerdctl/
-rw-r--r-- 0/0 12386 2023-11-04 08:49 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2023-11-04 08:49 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2023-11-04 08:49 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2023-11-04 08:49 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2023-11-04 08:49 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 73768 2023-11-04 08:49 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1846 2023-11-04 08:49 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2023-11-04 08:49 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2023-11-04 08:49 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2023-11-04 08:49 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2023-11-04 08:49 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2023-11-04 08:49 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2023-11-04 08:49 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2023-11-04 08:49 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 2439 2023-11-04 08:49 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2023-11-04 08:49 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2023-11-04 08:49 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2936 2023-11-04 08:49 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2023-11-04 08:49 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2023-11-04 08:49 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2023-11-04 08:49 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2023-11-04 08:49 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 5088 2023-11-04 08:49 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2023-11-04 08:49 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2023-11-04 08:49 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2023-11-04 08:56 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1152 2023-11-04 08:56 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 6400 2023-11-04 08:56 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v1.7.0
- containerd: v1.7.8
- runc: v1.1.10
- CNI plugins: v1.3.0
- BuildKit: v0.12.3
- Stargz Snapshotter: v0.15.1
- imgcrypt: v1.1.9
- RootlessKit: v1.1.1
- slirp4netns: v1.2.2
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.8
- Kubo (IPFS): v0.23.0
- Tini: v0.19.0
- buildg: v0.4.1
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.2/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.23.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
Quick start
Rootful
$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine
Rootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine
Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .
The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/6753862499
The sha256sum of the SHA256SUMS file itself is fd5d88d2b28f1fd27ff3448b4eea5c266873773ebd723ab1be3c7b26ef3d1a85
.
Release manager: Akihiro Suda (@AkihiroSuda)
v1.6.2
Changes
nerdctl compose
:- Fix
--env-file
(was broken since v1.6.0) (#2567)
- Fix
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-1.6.2-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-1.6.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-1.6.2-linux-amd64.tar.gz
-rwxr-xr-x root/root 24752128 2023-10-13 01:37 nerdctl
-rwxr-xr-x root/root 21618 2023-10-13 01:36 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 7187 2023-10-13 01:36 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-1.6.2-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2023-10-13 01:50 bin/
-rwxr-xr-x 0/0 27623705 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0 53353409 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 3788344 2023-10-13 01:46 bin/bypass4netns
-rwxr-xr-x 0/0 5283840 2023-10-13 01:46 bin/bypass4netnsd
-rwxr-xr-x 0/0 57479768 2023-10-13 01:48 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-10-09 21:44 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 21618 2023-10-13 01:47 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 7187 2023-10-13 01:47 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12279808 2023-10-13 01:49 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 59637768 2023-03-08 10:08 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20397229 2023-10-13 01:50 bin/ctd-decoder
-rwxr-xr-x 0/0 28926368 2023-10-13 01:47 bin/ctr
-rwxr-xr-x 0/0 29367290 2023-10-13 01:50 bin/ctr-enc
-rwxr-xr-x 0/0 26664136 2023-03-08 10:08 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2023-10-13 01:50 bin/fuse-overlayfs
-rwxr-xr-x 0/0 83712312 2023-10-05 17:02 bin/ipfs
-rwxr-xr-x 0/0 24731648 2023-10-13 01:47 bin/nerdctl
-rwxr-xr-x 0/0 10113536 2023-05-30 06:31 bin/rootlessctl
-rwxr-xr-x 0/0 11600435 2023-05-30 06:31 bin/rootlesskit
-rwxr-xr-x 0/0 15042424 2023-10-13 01:47 bin/runc
-rwxr-xr-x 0/0 2346328 2023-10-13 01:50 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2023-10-13 01:50 bin/tini
drwxr-xr-x 0/0 0 2023-10-13 01:49 lib/
drwxr-xr-x 0/0 0 2023-10-13 01:49 lib/systemd/
drwxr-xr-x 0/0 0 2023-10-13 01:49 lib/systemd/system/
-rw-r--r-- 0/0 1475 2023-10-13 01:49 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2023-10-13 01:45 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2023-10-13 01:49 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2023-10-13 01:49 libexec/
drwxrwxr-x 0/0 0 2023-10-13 01:49 libexec/cni/
-rwxr-xr-x 0/0 4016001 2023-05-09 19:53 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4531309 2023-05-09 19:53 libexec/cni/bridge
-rwxr-xr-x 0/0 10816051 2023-05-09 19:53 libexec/cni/dhcp
-rwxr-xr-x 0/0 4171248 2023-05-09 19:53 libexec/cni/dummy
-rwxr-xr-x 0/0 4649749 2023-05-09 19:53 libexec/cni/firewall
-rwxr-xr-x 0/0 4059321 2023-05-09 19:53 libexec/cni/host-device
-rwxr-xr-x 0/0 3444776 2023-05-09 19:53 libexec/cni/host-local
-rwxr-xr-x 0/0 4193323 2023-05-09 19:53 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3514598 2023-05-09 19:53 libexec/cni/loopback
-rwxr-xr-x 0/0 4227193 2023-05-09 19:53 libexec/cni/macvlan
-rwxr-xr-x 0/0 3955775 2023-05-09 19:53 libexec/cni/portmap
-rwxr-xr-x 0/0 4348835 2023-05-09 19:53 libexec/cni/ptp
-rwxr-xr-x 0/0 3716095 2023-05-09 19:53 libexec/cni/sbr
-rwxr-xr-x 0/0 2984504 2023-05-09 19:53 libexec/cni/static
-rwxr-xr-x 0/0 4258344 2023-05-09 19:53 libexec/cni/tap
-rwxr-xr-x 0/0 3603365 2023-05-09 19:53 libexec/cni/tuning
-rwxr-xr-x 0/0 4187498 2023-05-09 19:53 libexec/cni/vlan
-rwxr-xr-x 0/0 3754911 2023-05-09 19:53 libexec/cni/vrf
drwxr-xr-x 0/0 0 2023-10-13 01:47 share/
drwxr-xr-x 0/0 0 2023-10-13 01:47 share/doc/
drwxr-xr-x 0/0 0 2023-10-13 01:47 share/doc/nerdctl/
-rw-r--r-- 0/0 12386 2023-10-13 01:36 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2023-10-13 01:36 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2023-10-13 01:36 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2023-10-13 01:36 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2023-10-13 01:36 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 73625 2023-10-13 01:36 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1846 2023-10-13 01:36 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2023-10-13 01:36 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2023-10-13 01:36 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 2435 2023-10-13 01:36 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2023-10-13 01:36 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2023-10-13 01:36 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2023-10-13 01:36 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 2439 2023-10-13 01:36 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2023-10-13 01:36 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2023-10-13 01:36 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2936 2023-10-13 01:36 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2023-10-13 01:36 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2023-10-13 01:36 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2023-10-13 01:36 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2023-10-13 01:36 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 5088 2023-10-13 01:36 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2020 2023-10-13 01:36 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2023-10-13 01:36 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2023-10-13 01:50 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1151 2023-10-13 01:50 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 6300 2023-10-13 01:50 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v1.6.2
- containerd: v1.7.7
- runc: v1.1.9
- CNI plugins: v1.3.0
- BuildKit: v0.12.2
- Stargz Snapshotter: v0.14.3
- imgcrypt: v1.1.8
- RootlessKit: v1.1.1
- slirp4netns: v1.2.2
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.7
- Kubo (IPFS): v0.23.0
- Tini: v0.19.0
- buildg: v0.4.1
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.2/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.23.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
Quick start
Rootful
$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine
Rootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine
Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .
The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/6502927032
The sha256sum of the SHA256SUMS file itself is 3269e3ef2a4711dec3f5ecc55d47644d602773f92eb1b7973c3b8a45c95e6664
.
Release manager: Akihiro Suda (@AkihiroSuda)