Nerdctl Versions Save

contaiNERD CTL - Docker-compatible CLI for containerd, with support for Compose, Rootless, eStargz, OCIcrypt, IPFS, ...

v1.7.2

6 months ago

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:
    • Update containerd (1.7.11), BuildKit (0.12.4), CNI plugins (1.4.0) (#2680, #2692, #2697)

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

6 months ago

Changes

  • nerdctl diff:

    • Add nerdctl diff command (#2626, thanks to @minuk-dev)

  • nerdctl pull:

    • Add --soci-index-digest flag to specify a particular index digest for SOCI (#2638, thanks to @sondavidb)

  • nerdctl compose exec:

    • Fix TTY compatibility issues with docker compose exec (#2650, thanks to @yankay)

  • nerdctl-full:

    • Update containerd (1.7.10), Kubo (0.24.0) (#2659, #2671)

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

7 months ago

Added the initial support for IPv6 (#1558) and CernVM-FS (#2599)

Changes

  • nerdctl network:

    • Add the initial support for IPv6 (#1558, thanks to @yuchanns)
    • Implement com.docker.network.bridge.enable_ip_masquerade (#2592, thanks to @yankay)

  • nerdctl run:

    • Add the support for CernVM-FS snapshotter (#2599, thanks to @marcoverl)
    • Implement --network <ID> (#2589, thanks to @fahedouch)

  • nerdctl ps:

    • Fix --format '{{.Names}}' incompatibility (#2595, thanks to @yankay)
    • Implement --format '{{Label "foo"}}' (#2619)

  • nerdctl-full:

    • Update containerd (1.7.8), runc (1.1.10), BuildKit (0.12.3), imgcrypt (1.1.9), stargz-snapshotter (0.15.1), containerd-fuse-overlayfs (1.0.8) (#2618, #2620, #2624, thanks to @ktock)
    • Build containerd and ipfs as static binaries (#2610)

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

8 months ago

Changes

  • nerdctl compose:
    • Fix --env-file (was broken since v1.6.0) (#2567)

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)

v1.6.1

8 months ago

Changes

  • nerdctl network ls:

    • Add --filter flag (#2522, thanks to @yankay)

  • nerdctl image convert:

    • Add --zstd flag (#2530, thanks to @henry118)

  • nerdctl compose ps:

    • Add --filter, --status, --quiet, --services, and --all flags (#2509, thanks to @tanghaowillow)

  • Misc:

    • CNI: prioritize /opt/cni/bin over /usr/lib/cni (#2541)

  • nerdctl-full:

    • update containerd (1.7.7), slirp4netns (1.2.2), containerd-fuse-overlayfs (1.0.7), Kubo (0.23.0) (#2556)

Full changes: https://github.com/containerd/nerdctl/milestone/32 Thanks to @ginglis13 @henry118 @tanghaowillow @tces1 @testwill @yankay @zhuangqh

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

-rwxr-xr-x root/root  24752128 2023-10-12 02:15 nerdctl
-rwxr-xr-x root/root     21618 2023-10-12 02:14 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      7187 2023-10-12 02:14 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2023-10-12 02:26 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-12 02:22 bin/bypass4netns
-rwxr-xr-x 0/0         5283840 2023-10-12 02:23 bin/bypass4netnsd
-rwxr-xr-x 0/0        57479768 2023-10-12 02:24 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-12 02:24 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            7187 2023-10-12 02:24 bin/containerd-rootless.sh
-rwxr-xr-x 0/0        12279808 2023-10-12 02:25 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-12 02:26 bin/ctd-decoder
-rwxr-xr-x 0/0        28926368 2023-10-12 02:24 bin/ctr
-rwxr-xr-x 0/0        29367290 2023-10-12 02:26 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-12 02:26 bin/fuse-overlayfs
-rwxr-xr-x 0/0        83712312 2023-10-05 17:02 bin/ipfs
-rwxr-xr-x 0/0        24731648 2023-10-12 02:24 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-12 02:23 bin/runc
-rwxr-xr-x 0/0         2346328 2023-10-12 02:26 bin/slirp4netns
-rwxr-xr-x 0/0          870496 2023-10-12 02:26 bin/tini
drwxr-xr-x 0/0               0 2023-10-12 02:25 lib/
drwxr-xr-x 0/0               0 2023-10-12 02:25 lib/systemd/
drwxr-xr-x 0/0               0 2023-10-12 02:25 lib/systemd/system/
-rw-r--r-- 0/0            1475 2023-10-12 02:25 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1414 2023-10-12 02:22 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2023-10-12 02:25 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2023-10-12 02:25 libexec/
drwxrwxr-x 0/0               0 2023-10-12 02:25 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-12 02:24 share/
drwxr-xr-x 0/0               0 2023-10-12 02:24 share/doc/
drwxr-xr-x 0/0               0 2023-10-12 02:24 share/doc/nerdctl/
-rw-r--r-- 0/0           12386 2023-10-12 02:14 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2023-10-12 02:14 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2023-10-12 02:14 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2023-10-12 02:14 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            3996 2023-10-12 02:14 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           73625 2023-10-12 02:14 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1846 2023-10-12 02:14 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            5329 2023-10-12 02:14 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2023-10-12 02:14 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            2435 2023-10-12 02:14 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2023-10-12 02:14 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14217 2023-10-12 02:14 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2023-10-12 02:14 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            2439 2023-10-12 02:14 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0           14463 2023-10-12 02:14 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            1748 2023-10-12 02:14 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2936 2023-10-12 02:14 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2596 2023-10-12 02:14 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2023-10-12 02:14 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2023-10-12 02:14 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2023-10-12 02:14 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            5088 2023-10-12 02:14 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0            2020 2023-10-12 02:14 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0           10312 2023-10-12 02:14 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2023-10-12 02:26 share/doc/nerdctl-full/
-rw-r--r-- 0/0            1151 2023-10-12 02:26 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            6300 2023-10-12 02:26 share/doc/nerdctl-full/SHA256SUMS
Included components

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

# nerdctl (full distribution)
- nerdctl: v1.6.1
- 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/6490434410

The sha256sum of the SHA256SUMS file itself is 32242fd892d994e9b041aba52f1de3eb501d008ddb25e2655f696952ed35e35d .

Release manager: Akihiro Suda (@AkihiroSuda)

v1.6.0

8 months ago

This release improves compatibility with Docker 23, adds the support for pushing SOCI images, and allows running Linux containers on FreeBSD.

Changes

  • nerdctl push:

    • Support push with soci (#2467, thanks to @ningziwen)

  • nerdctl compose:

    • Implement nerdctl compose cp. (#2499, #2513, thanks to @yankay)
    • Implement nerdctl compose exec -T (#2507)
    • Silence warning build.config should be relative path (#2510)

  • nerdctl attach:

    • Implement nerdctl attach (#2108, thanks to @davidhsingyuchen)

  • nerdctl volume create:

    • Support creating anonymous volumes (#2433, thanks to @yankay)

  • nerdctl version:

    • Fulfill the version field from debug/buildinfo to support go install (#2444)
    • Skip inspecting rootless daemon if the daemon is not running (2514)

  • Misc:

    • Improve compatibility with Docker 23 (#2427, #2498, thanks to @yankay)
    • FreeBSD: support Linux containers and BuildKit (#2425, thanks to @akhramov)

  • nerdctl-full:

    • Update runc (1.1.9), containerd (1.7.6), BuildKit (0.12.2), imgcrypt (1.1.8), RootlessKit (1.1.1), slirp4netns (1.2.1), Kubo (0.22.0) (#2435, #2497, #2515)

  • Project:

    • MAINTAINERS: add Kay Yan (@yankay) as a REVIEWER (#2482)

Full changes: https://github.com/containerd/nerdctl/milestone/29?closed=1 Thanks to 
@akhramov
@austinvazquez @davidhsingyuchen @fahedouch @gabriel-samfira @metux @ningziwen @testwill @vsiravar @webwurst @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.6.0-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-1.6.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.6.0-linux-amd64.tar.gz 

-rwxr-xr-x root/root  24567808 2023-09-19 06:48 nerdctl
-rwxr-xr-x root/root     21618 2023-09-19 06:47 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      7187 2023-09-19 06:47 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2023-09-19 06:59 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-09-19 06:55 bin/bypass4netns
-rwxr-xr-x 0/0         5283840 2023-09-19 06:55 bin/bypass4netnsd
-rwxr-xr-x 0/0        57355480 2023-09-19 06:57 bin/containerd
-rwxr-xr-x 0/0        10432512 2023-05-11 08:23 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           21618 2023-09-19 06:57 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            7187 2023-09-19 06:57 bin/containerd-rootless.sh
-rwxr-xr-x 0/0        12275712 2023-09-19 06:58 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        20394184 2023-09-19 06:59 bin/ctd-decoder
-rwxr-xr-x 0/0        28830976 2023-09-19 06:57 bin/ctr
-rwxr-xr-x 0/0        29366269 2023-09-19 06:59 bin/ctr-enc
-rwxr-xr-x 0/0        26664136 2023-03-08 10:08 bin/ctr-remote
-rwxr-xr-x 0/0         1785448 2023-09-19 06:59 bin/fuse-overlayfs
-rwxr-xr-x 0/0        83555368 2023-08-08 18:07 bin/ipfs
-rwxr-xr-x 0/0        24539136 2023-09-19 06:57 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        15038440 2023-09-19 06:56 bin/runc
-rwxr-xr-x 0/0         2346328 2023-09-19 06:59 bin/slirp4netns
-rwxr-xr-x 0/0          870496 2023-09-19 06:59 bin/tini
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/systemd/
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/systemd/system/
-rw-r--r-- 0/0            1475 2023-09-19 06:58 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1414 2023-09-19 06:55 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2023-09-19 06:58 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2023-09-19 06:58 libexec/
drwxrwxr-x 0/0               0 2023-09-19 06:58 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-09-19 06:57 share/
drwxr-xr-x 0/0               0 2023-09-19 06:57 share/doc/
drwxr-xr-x 0/0               0 2023-09-19 06:57 share/doc/nerdctl/
-rw-r--r-- 0/0           12386 2023-09-19 06:47 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2023-09-19 06:47 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2023-09-19 06:47 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2023-09-19 06:47 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            3996 2023-09-19 06:47 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           72895 2023-09-19 06:47 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1846 2023-09-19 06:47 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            5329 2023-09-19 06:47 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2023-09-19 06:47 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            2435 2023-09-19 06:47 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2023-09-19 06:47 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14217 2023-09-19 06:47 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2023-09-19 06:47 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            2439 2023-09-19 06:47 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0           14463 2023-09-19 06:47 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            1748 2023-09-19 06:47 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2936 2023-09-19 06:47 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2596 2023-09-19 06:47 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2023-09-19 06:47 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2023-09-19 06:47 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2023-09-19 06:47 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            5088 2023-09-19 06:47 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0            2003 2023-09-19 06:47 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0           10312 2023-09-19 06:47 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2023-09-19 06:59 share/doc/nerdctl-full/
-rw-r--r-- 0/0            1151 2023-09-19 06:59 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            6300 2023-09-19 06:59 share/doc/nerdctl-full/SHA256SUMS
Included components

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

# nerdctl (full distribution)
- nerdctl: v1.6.0
- containerd: v1.7.6
- 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.1
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.6
- Kubo (IPFS): v0.22.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.1/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.22.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/6232118186

The sha256sum of the SHA256SUMS file itself is 86ae32752c992de4b32161f1ea28962b3010b3757a30732f437c98f72a92fe62 .

Release manager: Akihiro Suda (@AkihiroSuda)

v1.5.0

10 months ago

  • nerdctl compose now emulates Docker Compose v2. This change affects internal container names, e.g., example_wordpress_1 → example-wordpress-1. (#1644)

  • Lazy-pulling now supports SOCI (#2347)

Changes

  • nerdctl run:

    • Support lazy-pulling with SOCI (#2347, thanks to @CodeChanning @ningziwen)
    • Add --detach-keys flag (#2128, thanks to @davidhsingyuchen)
    • Add --volumes-from flag (#2241, thanks to @ningziwen)
    • Fix a conflict on TCP port 49154 (#2263, thanks to @tces1)

  • nerdctl create, nerdctl update, nerdctl kill:

    • Fix the behavior of --restart (#2308, #2314, #2330, thanks to @yankay)

  • nerdctl network create:

    • Fix overlap on 10.4.0.0/24 (#2358, thanks to @yldoge)

  • nerdctl cp:

    • Support copying files in and out of stopped containers (#2355, thanks to @vsiravar)

  • nerdctl push:

    • Fix concurrent push (#2404, thanks to @zhenxuanxin)

  • nerdctl build:

    • Add --network flag (#2383, thanks to @vsiravar)

  • nerdctl compose:

    • Emulate Docker Compose v2 (#1644, thanks to @djdongjin)
    • Support shm_size (#2267, thanks to @surenkov)
    • Support build secrets (#2278, thanks to @andrewbelu)
    • Support replicas = 0 (#2361, thanks to @yankay)

  • nerdctl-full:

    • Update BuildKit (0.12.0), containerd (1.7.3), runc (1.1.8), Kubo (0.21.0) (#2734, #2401, thanks to @ginglis13)

Full changes: https://github.com/containerd/nerdctl/issues?q=is%3Aclosed+milestone%3Av1.5.0 Thanks to @CodeChanning @andrewbelu @austinvazquez @aznashwan @davidhsingyuchen @djdongjin @fahedouch @ginglis13 @ktock @mook-as @ningziwen @sbuckfelder @surenkov @suyanhanx @tces1 @vsiravar @weikequ @yankay @yldoge @zhenxuanxin

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

-rwxr-xr-x root/root  24543232 2023-07-31 10:52 nerdctl
-rwxr-xr-x root/root     21622 2023-07-31 10:51 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      7187 2023-07-31 10:51 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2023-07-31 11:02 bin/
-rwxr-xr-x 0/0        27632916 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        53356944 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0         3696856 2023-07-31 10:58 bin/bypass4netns
-rwxr-xr-x 0/0         5242880 2023-07-31 10:59 bin/bypass4netnsd
-rwxr-xr-x 0/0        57950744 2023-07-31 11:00 bin/containerd
-rwxr-xr-x 0/0        10432512 2023-05-11 08:23 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           21622 2023-07-31 11:00 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            7187 2023-07-31 11:00 bin/containerd-rootless.sh
-rwxr-xr-x 0/0        12374016 2023-07-31 11:01 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        20603375 2023-07-31 11:02 bin/ctd-decoder
-rwxr-xr-x 0/0        28951224 2023-07-31 11:00 bin/ctr
-rwxr-xr-x 0/0        29257695 2023-07-31 11:02 bin/ctr-enc
-rwxr-xr-x 0/0        26664136 2023-03-08 10:08 bin/ctr-remote
-rwxr-xr-x 0/0         1785384 2023-07-31 11:02 bin/fuse-overlayfs
-rwxr-xr-x 0/0        83672728 2023-07-03 08:56 bin/ipfs
-rwxr-xr-x 0/0        24514560 2023-07-31 11:00 bin/nerdctl
-rwxr-xr-x 0/0         9847163 2022-11-15 11:19 bin/rootlessctl
-rwxr-xr-x 0/0        11311662 2022-11-15 11:19 bin/rootlesskit
-rwxr-xr-x 0/0        14716256 2023-07-31 10:59 bin/runc
-rwxr-xr-x 0/0         2338128 2023-07-31 11:02 bin/slirp4netns
-rwxr-xr-x 0/0          870496 2023-07-31 11:02 bin/tini
drwxr-xr-x 0/0               0 2023-07-31 11:01 lib/
drwxr-xr-x 0/0               0 2023-07-31 11:01 lib/systemd/
drwxr-xr-x 0/0               0 2023-07-31 11:01 lib/systemd/system/
-rw-r--r-- 0/0            1475 2023-07-31 11:01 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1414 2023-07-31 10:58 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2023-07-31 11:01 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2023-07-31 11:01 libexec/
drwxrwxr-x 0/0               0 2023-07-31 11:01 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-07-31 11:00 share/
drwxr-xr-x 0/0               0 2023-07-31 11:00 share/doc/
drwxr-xr-x 0/0               0 2023-07-31 11:00 share/doc/nerdctl/
-rw-r--r-- 0/0           12358 2023-07-31 10:51 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2023-07-31 11:00 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2023-07-31 10:51 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2023-07-31 10:51 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            3996 2023-07-31 10:51 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           70914 2023-07-31 10:51 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1846 2023-07-31 10:51 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            5329 2023-07-31 10:51 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2023-07-31 10:51 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            2435 2023-07-31 10:51 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2023-07-31 10:51 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14217 2023-07-31 10:51 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0            1197 2023-07-31 10:51 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            2439 2023-07-31 10:51 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0           14463 2023-07-31 10:51 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            1748 2023-07-31 10:51 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2936 2023-07-31 10:51 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2596 2023-07-31 10:51 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2023-07-31 10:51 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2023-07-31 10:51 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2023-07-31 10:51 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            5088 2023-07-31 10:51 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0           10312 2023-07-31 10:51 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2023-07-31 11:02 share/doc/nerdctl-full/
-rw-r--r-- 0/0            1151 2023-07-31 11:02 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            6201 2023-07-31 11:02 share/doc/nerdctl-full/SHA256SUMS
Included components

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

# nerdctl (full distribution)
- nerdctl: v1.5.0
- containerd: v1.7.3
- runc: v1.1.8
- CNI plugins: v1.3.0
- BuildKit: v0.12.0
- Stargz Snapshotter: v0.14.3
- imgcrypt: v1.1.7
- RootlessKit: v1.1.0
- slirp4netns: v1.2.0
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.12
- containerd-fuse-overlayfs: v1.0.6
- Kubo (IPFS): v0.21.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.0/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.12/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.21.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/5713789420

The sha256sum of the SHA256SUMS file itself is ac943770dd4a23c3ff2daa8baa2d3a9daa763a7f08e362f1ed526a21556dc07e .

Release manager: Akihiro Suda (@AkihiroSuda)

v1.4.0

1 year ago

This release fixes an incompatibility with runc >= 1.1.6 (#2174). Also introduces support for Cosign keyless mode (#2185).

Changes

  • nerdctl create:

    • Massive refactoring (#1970, thanks to @Laitr0n)

  • nerdctl exec:

    • Fix console size (#2182, thanks to @ChangJH-Mark)

  • nerdctl logs:

    • Allow printing of container logs that are not running (#2227, thanks to @chzhuo)

  • nerdctl images:

    • Silence Silence WARN[0000] failed to get unpacked size of image (#2245)

  • nerdctl pull:

    • Support cosign keyless mode (#2185)

  • nerdctl system prune:

    • skip pruning build cache if buildkit is not running (#2246)

  • nerdctl compose:

    • Support cosign keyless mode (#2207, thanks to @ningziwen)

  • nerdctl-full: update runc (1.1.7), containerd (1.7.1), CNI plugins (1.3.0), BuildKit (0.11.6), Kubo (0.20.0) containerd-fuse-overlayfs (1.0.6), fuse-overlayfs (1.1.2) (#2174, #2228, #2230)

Full changes: https://github.com/containerd/nerdctl/milestone/30?closed=1 Thanks to @ChangJH-Mark @Laitr0n @chzhuo @dardelean @dcantah @gerbercloud @imeoer @ningziwen @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.4.0-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-1.4.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.4.0-linux-amd64.tar.gz 

-rwxr-xr-x root/root  24379392 2023-05-20 14:30 nerdctl
-rwxr-xr-x root/root     21622 2023-05-20 14:29 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      7187 2023-05-20 14:29 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2023-05-20 14:43 bin/
-rwxr-xr-x 0/0        27083291 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        52023485 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0         3688664 2023-05-20 14:39 bin/bypass4netns
-rwxr-xr-x 0/0         5238784 2023-05-20 14:39 bin/bypass4netnsd
-rwxr-xr-x 0/0        57913112 2023-05-20 14:42 bin/containerd
-rwxr-xr-x 0/0        10432512 2023-05-11 08:23 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           21622 2023-05-20 14:41 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            7187 2023-05-20 14:41 bin/containerd-rootless.sh
-rwxr-xr-x 0/0        12349440 2023-05-20 14:42 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        20526993 2023-05-20 14:43 bin/ctd-decoder
-rwxr-xr-x 0/0        28917496 2023-05-20 14:41 bin/ctr
-rwxr-xr-x 0/0        29190395 2023-05-20 14:43 bin/ctr-enc
-rwxr-xr-x 0/0        26664136 2023-03-08 10:08 bin/ctr-remote
-rwxr-xr-x 0/0         1785384 2023-05-20 14:43 bin/fuse-overlayfs
-rwxr-xr-x 0/0        82803928 2023-05-09 10:49 bin/ipfs
-rwxr-xr-x 0/0        24350720 2023-05-20 14:41 bin/nerdctl
-rwxr-xr-x 0/0         9847163 2022-11-15 11:19 bin/rootlessctl
-rwxr-xr-x 0/0        11311662 2022-11-15 11:19 bin/rootlesskit
-rwxr-xr-x 0/0        13669536 2023-05-20 14:40 bin/runc
-rwxr-xr-x 0/0         2338128 2023-05-20 14:43 bin/slirp4netns
-rwxr-xr-x 0/0          870496 2023-05-20 14:43 bin/tini
drwxr-xr-x 0/0               0 2023-05-20 14:42 lib/
drwxr-xr-x 0/0               0 2023-05-20 14:42 lib/systemd/
drwxr-xr-x 0/0               0 2023-05-20 14:43 lib/systemd/system/
-rw-r--r-- 0/0            1475 2023-05-20 14:43 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1414 2023-05-20 14:38 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2023-05-20 14:43 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2023-05-20 14:42 libexec/
drwxrwxr-x 0/0               0 2023-05-20 14:42 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-05-20 14:41 share/
drwxr-xr-x 0/0               0 2023-05-20 14:41 share/doc/
drwxr-xr-x 0/0               0 2023-05-20 14:41 share/doc/nerdctl/
-rw-r--r-- 0/0           12358 2023-05-20 14:29 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2023-05-20 14:41 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2023-05-20 14:29 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2023-05-20 14:29 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            3996 2023-05-20 14:29 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           70607 2023-05-20 14:29 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1846 2023-05-20 14:29 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            5329 2023-05-20 14:29 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2023-05-20 14:29 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            2435 2023-05-20 14:29 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2023-05-20 14:29 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14217 2023-05-20 14:29 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0            1197 2023-05-20 14:29 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            2439 2023-05-20 14:29 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0           14463 2023-05-20 14:29 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            1748 2023-05-20 14:29 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2936 2023-05-20 14:29 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2596 2023-05-20 14:29 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2023-05-20 14:29 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2023-05-20 14:29 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15626 2023-05-20 14:29 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            5088 2023-05-20 14:29 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0           10370 2023-05-20 14:29 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2023-05-20 14:43 share/doc/nerdctl-full/
-rw-r--r-- 0/0            1151 2023-05-20 14:43 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            6201 2023-05-20 14:43 share/doc/nerdctl-full/SHA256SUMS
Included components

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

# nerdctl (full distribution)
- nerdctl: v1.4.0
- containerd: v1.7.1
- runc: v1.1.7
- CNI plugins: v1.3.0
- BuildKit: v0.11.6
- Stargz Snapshotter: v0.14.3
- imgcrypt: v1.1.7
- RootlessKit: v1.1.0
- slirp4netns: v1.2.0
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.12
- containerd-fuse-overlayfs: v1.0.6
- Kubo (IPFS): v0.20.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.0/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.12/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.20.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/5032691620

The sha256sum of the SHA256SUMS file itself is 8d7149cf90edf33a588f1103da79f996279da87503bbf02e5630e3876de95a31 .

Release manager: Akihiro Suda (@AkihiroSuda)

v1.3.1

1 year ago

Changes

  • nerdctl run:
    • Fix #2164 sudo nerdctl run -p <container port> <image> always defaults to 49153 host port (#2169, thanks to @vsiravar)
    • Make tty behavior compatible to Docker (#2167, thanks to @ktock)
  • nerdctl push:
    • Fix cosign regression in nerdctl v1.3.0 (#2172, thanks to @ningziwen)
  • nerdctl compose:
    • Implement Bind.CreateHostPath (#2150)
  • nerdctl-full:
    • Update Kubo to v0.19.1 (#2181)

Full changes: https://github.com/containerd/nerdctl/milestone/26?closed=1 Thanks to @austinvazquez @ktock @mook-as @ningziwen @vsiravar

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.3.1-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-1.3.1-linux-amd64.tar.gz): Includes dependencies such as containerd, runc, and CNI

Minimal

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

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

-rwxr-xr-x root/root  24952832 2023-04-14 06:13 nerdctl
-rwxr-xr-x root/root     21622 2023-04-14 06:12 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      7032 2023-04-14 06:12 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2023-04-14 06:26 bin/
-rwxr-xr-x 0/0        27080076 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        52016425 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0         3692760 2023-04-14 06:21 bin/bypass4netns
-rwxr-xr-x 0/0         5238784 2023-04-14 06:22 bin/bypass4netnsd
-rwxr-xr-x 0/0        57380280 2023-04-14 06:24 bin/containerd
-rwxr-xr-x 0/0        10219520 2022-11-09 07:56 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           21622 2023-04-14 06:23 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            7032 2023-04-14 06:23 bin/containerd-rootless.sh
-rwxr-xr-x 0/0        12324864 2023-04-14 06:25 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        20532693 2023-04-14 06:26 bin/ctd-decoder
-rwxr-xr-x 0/0        28883704 2023-04-14 06:23 bin/ctr
-rwxr-xr-x 0/0        29179519 2023-04-14 06:26 bin/ctr-enc
-rwxr-xr-x 0/0        26664136 2023-03-08 10:08 bin/ctr-remote
-rwxr-xr-x 0/0         1784312 2023-04-14 06:26 bin/fuse-overlayfs
-rwxr-xr-x 0/0        81638824 2023-04-05 19:20 bin/ipfs
-rwxr-xr-x 0/0        24924160 2023-04-14 06:23 bin/nerdctl
-rwxr-xr-x 0/0         9847163 2022-11-15 11:19 bin/rootlessctl
-rwxr-xr-x 0/0        11311662 2022-11-15 11:19 bin/rootlesskit
-rwxr-xr-x 0/0        13660920 2023-04-14 06:23 bin/runc
-rwxr-xr-x 0/0         2338128 2023-04-14 06:26 bin/slirp4netns
-rwxr-xr-x 0/0          870496 2023-04-14 06:26 bin/tini
drwxr-xr-x 0/0               0 2023-04-14 06:25 lib/
drwxr-xr-x 0/0               0 2023-04-14 06:25 lib/systemd/
drwxr-xr-x 0/0               0 2023-04-14 06:25 lib/systemd/system/
-rw-r--r-- 0/0            1475 2023-04-14 06:25 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1414 2023-04-14 06:21 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2023-04-14 06:25 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2023-04-14 06:25 libexec/
drwxrwxr-x 0/0               0 2023-04-14 06:25 libexec/cni/
-rwxr-xr-x 0/0         3859475 2023-01-16 21:42 libexec/cni/bandwidth
-rwxr-xr-x 0/0         4299004 2023-01-16 21:42 libexec/cni/bridge
-rwxr-xr-x 0/0        10167415 2023-01-16 21:42 libexec/cni/dhcp
-rwxr-xr-x 0/0         3986082 2023-01-16 21:42 libexec/cni/dummy
-rwxr-xr-x 0/0         4385098 2023-01-16 21:42 libexec/cni/firewall
-rwxr-xr-x 0/0         3870731 2023-01-16 21:42 libexec/cni/host-device
-rwxr-xr-x 0/0         3287319 2023-01-16 21:42 libexec/cni/host-local
-rwxr-xr-x 0/0         3999593 2023-01-16 21:42 libexec/cni/ipvlan
-rwxr-xr-x 0/0         3353028 2023-01-16 21:42 libexec/cni/loopback
-rwxr-xr-x 0/0         4029261 2023-01-16 21:42 libexec/cni/macvlan
-rwxr-xr-x 0/0         3746163 2023-01-16 21:42 libexec/cni/portmap
-rwxr-xr-x 0/0         4161070 2023-01-16 21:42 libexec/cni/ptp
-rwxr-xr-x 0/0         3550152 2023-01-16 21:42 libexec/cni/sbr
-rwxr-xr-x 0/0         2845685 2023-01-16 21:42 libexec/cni/static
-rwxr-xr-x 0/0         3437180 2023-01-16 21:42 libexec/cni/tuning
-rwxr-xr-x 0/0         3993252 2023-01-16 21:42 libexec/cni/vlan
-rwxr-xr-x 0/0         3586502 2023-01-16 21:42 libexec/cni/vrf
drwxr-xr-x 0/0               0 2023-04-14 06:23 share/
drwxr-xr-x 0/0               0 2023-04-14 06:23 share/doc/
drwxr-xr-x 0/0               0 2023-04-14 06:23 share/doc/nerdctl/
-rw-r--r-- 0/0           12358 2023-04-14 06:12 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2023-04-14 06:23 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2023-04-14 06:12 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2023-04-14 06:12 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            3996 2023-04-14 06:12 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           68011 2023-04-14 06:12 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1846 2023-04-14 06:12 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            5329 2023-04-14 06:12 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            8040 2023-04-14 06:12 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            2435 2023-04-14 06:12 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2023-04-14 06:12 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14217 2023-04-14 06:12 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0            1197 2023-04-14 06:12 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            2439 2023-04-14 06:12 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0           14463 2023-04-14 06:12 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            1748 2023-04-14 06:12 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2936 2023-04-14 06:12 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2596 2023-04-14 06:12 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2023-04-14 06:12 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2023-04-14 06:12 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15626 2023-04-14 06:12 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            5088 2023-04-14 06:12 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0           10370 2023-04-14 06:12 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2023-04-14 06:26 share/doc/nerdctl-full/
-rw-r--r-- 0/0            1151 2023-04-14 06:26 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            6117 2023-04-14 06:26 share/doc/nerdctl-full/SHA256SUMS
Included components

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

# nerdctl (full distribution)
- nerdctl: v1.3.1
- containerd: v1.7.0
- runc: v1.1.5
- CNI plugins: v1.2.0
- BuildKit: v0.11.5
- Stargz Snapshotter: v0.14.3
- imgcrypt: v1.1.7
- RootlessKit: v1.1.0
- slirp4netns: v1.2.0
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.11
- containerd-fuse-overlayfs: v1.0.5
- Kubo (IPFS): v0.19.1
- 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.0/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 3](https://github.com/containers/fuse-overlayfs/blob/v1.11/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.19.1/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/4696934691

The sha256sum of the SHA256SUMS file itself is 91dac8444a59adb6ef90ca6c05f26c8ed3d47b0e1f90800f4c945390af268a38 .

Release manager: Akihiro Suda @AkihiroSuda

v1.3.0

1 year ago

Changes

Key features :

  • New Maintainers' guide is available. This is the first GA release managed by a non-core maintainer 😎
  • Support notation for signing and verifying signatures
  • Many windows refacto and improvements are embedded in this GA release
  • Fix operation not permitted with systemd-homed for rootless mode (#2056 , thanks to @AkihiroSuda )

  • nerdctl run:

    • Port Windows device support from containerd (#2079, thanks to @adamrehn)
    • Resolve special ip host-gateway (#1978, thanks to @ningziwen)

  • nerdctl push:

    • Support -q in nerdctl push(#2132, thanks to @djdongjin )

  • nerdctl inspect:

    • Support State.Error field in inspect command (#2073, thanks to @fahedouch)

  • nerdctl image inspect:

    • Add support for showing image size on inspect (#2110 , thanks to @manugupt1)

  • nerdctl compose:

    • Add support for profiles (#2042 , thanks to @danishprakash)

  • nerdctl top:

    • Fix the top command on Windows (#2038 , thanks to @dardelean)

  • nerdctl help:

    • Fix show hidden commands (#2125 , thanks to @yuchanns)

  • Lots of refactoring

Full changes: https://github.com/containerd/nerdctl/milestone/28?closed=1 thanks to @djdongjin @fahedouch @yuchanns @aznashwan @manugupt1 @dardelean @ktock @adamrehn @ningziwen @AkihiroSuda @suyanhanx @davidhsingyuchen @danishprakash @developer-guy

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

-rwxr-xr-x root/root  24920064 2023-04-05 12:22 nerdctl
-rwxr-xr-x root/root     21622 2023-04-05 12:21 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      7032 2023-04-05 12:21 containerd-rootless.sh

Full

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

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

drwxr-xr-x 0/0               0 2023-04-05 12:35 bin/
-rwxr-xr-x 0/0        27080076 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        52016425 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0         3692760 2023-04-05 12:31 bin/bypass4netns
-rwxr-xr-x 0/0         5238784 2023-04-05 12:31 bin/bypass4netnsd
-rwxr-xr-x 0/0        57380280 2023-04-05 12:33 bin/containerd
-rwxr-xr-x 0/0        10219520 2022-11-09 07:56 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           21622 2023-04-05 12:33 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            7032 2023-04-05 12:33 bin/containerd-rootless.sh
-rwxr-xr-x 0/0        12324864 2023-04-05 12:34 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        20532693 2023-04-05 12:35 bin/ctd-decoder
-rwxr-xr-x 0/0        28883704 2023-04-05 12:33 bin/ctr
-rwxr-xr-x 0/0        29179519 2023-04-05 12:35 bin/ctr-enc
-rwxr-xr-x 0/0        26664136 2023-03-08 10:08 bin/ctr-remote
-rwxr-xr-x 0/0         1784312 2023-04-05 12:35 bin/fuse-overlayfs
-rwxr-xr-x 0/0        81600768 2023-03-20 13:08 bin/ipfs
-rwxr-xr-x 0/0        24899584 2023-04-05 12:33 bin/nerdctl
-rwxr-xr-x 0/0         9847163 2022-11-15 11:19 bin/rootlessctl
-rwxr-xr-x 0/0        11311662 2022-11-15 11:19 bin/rootlesskit
-rwxr-xr-x 0/0        13660920 2023-04-05 12:32 bin/runc
-rwxr-xr-x 0/0         2338128 2023-04-05 12:35 bin/slirp4netns
-rwxr-xr-x 0/0          870496 2023-04-05 12:35 bin/tini
drwxr-xr-x 0/0               0 2023-04-05 12:34 lib/
drwxr-xr-x 0/0               0 2023-04-05 12:34 lib/systemd/
drwxr-xr-x 0/0               0 2023-04-05 12:34 lib/systemd/system/
-rw-r--r-- 0/0            1475 2023-04-05 12:34 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1414 2023-04-05 12:30 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2023-04-05 12:34 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2023-04-05 12:34 libexec/
drwxrwxr-x 0/0               0 2023-04-05 12:34 libexec/cni/
-rwxr-xr-x 0/0         3859475 2023-01-16 21:42 libexec/cni/bandwidth
-rwxr-xr-x 0/0         4299004 2023-01-16 21:42 libexec/cni/bridge
-rwxr-xr-x 0/0        10167415 2023-01-16 21:42 libexec/cni/dhcp
-rwxr-xr-x 0/0         3986082 2023-01-16 21:42 libexec/cni/dummy
-rwxr-xr-x 0/0         4385098 2023-01-16 21:42 libexec/cni/firewall
-rwxr-xr-x 0/0         3870731 2023-01-16 21:42 libexec/cni/host-device
-rwxr-xr-x 0/0         3287319 2023-01-16 21:42 libexec/cni/host-local
-rwxr-xr-x 0/0         3999593 2023-01-16 21:42 libexec/cni/ipvlan
-rwxr-xr-x 0/0         3353028 2023-01-16 21:42 libexec/cni/loopback
-rwxr-xr-x 0/0         4029261 2023-01-16 21:42 libexec/cni/macvlan
-rwxr-xr-x 0/0         3746163 2023-01-16 21:42 libexec/cni/portmap
-rwxr-xr-x 0/0         4161070 2023-01-16 21:42 libexec/cni/ptp
-rwxr-xr-x 0/0         3550152 2023-01-16 21:42 libexec/cni/sbr
-rwxr-xr-x 0/0         2845685 2023-01-16 21:42 libexec/cni/static
-rwxr-xr-x 0/0         3437180 2023-01-16 21:42 libexec/cni/tuning
-rwxr-xr-x 0/0         3993252 2023-01-16 21:42 libexec/cni/vlan
-rwxr-xr-x 0/0         3586502 2023-01-16 21:42 libexec/cni/vrf
drwxr-xr-x 0/0               0 2023-04-05 12:33 share/
drwxr-xr-x 0/0               0 2023-04-05 12:33 share/doc/
drwxr-xr-x 0/0               0 2023-04-05 12:33 share/doc/nerdctl/
-rw-r--r-- 0/0           12358 2023-04-05 12:21 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2023-04-05 12:33 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2023-04-05 12:21 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2023-04-05 12:21 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            3996 2023-04-05 12:21 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           68011 2023-04-05 12:21 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1846 2023-04-05 12:21 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            5329 2023-04-05 12:21 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            8040 2023-04-05 12:21 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            2435 2023-04-05 12:21 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2023-04-05 12:21 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14217 2023-04-05 12:21 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0            1197 2023-04-05 12:21 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            2439 2023-04-05 12:21 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0           14463 2023-04-05 12:21 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            1748 2023-04-05 12:21 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2936 2023-04-05 12:21 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2596 2023-04-05 12:21 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2023-04-05 12:21 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2023-04-05 12:21 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15626 2023-04-05 12:21 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            5088 2023-04-05 12:21 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0           10370 2023-04-05 12:21 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2023-04-05 12:35 share/doc/nerdctl-full/
-rw-r--r-- 0/0            1151 2023-04-05 12:35 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            6117 2023-04-05 12:35 share/doc/nerdctl-full/SHA256SUMS
Included components

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

# nerdctl (full distribution)
- nerdctl: v1.3.0
- containerd: v1.7.0
- runc: v1.1.5
- CNI plugins: v1.2.0
- BuildKit: v0.11.5
- Stargz Snapshotter: v0.14.3
- imgcrypt: v1.1.7
- RootlessKit: v1.1.0
- slirp4netns: v1.2.0
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.11
- containerd-fuse-overlayfs: v1.0.5
- Kubo (IPFS): v0.19.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.0/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 3](https://github.com/containers/fuse-overlayfs/blob/v1.11/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.19.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/4618402058

The sha256sum of the SHA256SUMS file itself is 36b09cb08e219eb8e93ae9120237ac51e25848b979e3a4f0ffced9c7b9b57c88 .

Release manager: Fahed Dorgaa (@fahedouch)