Releases · containerd/nerdctl

12 Dec 11:25

github-actions

v1.7.2

e32c4b0

v1.7.2

Changes

nerdctl run:
- Reset the default value of ulimit (#2682, thanks to @jiusanzhou)
- Dedup mounts for /etc/hosts /etc/resolv.conf (#2686, thanks to @yankay)
nerdctl-full:
- 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)

Contributors

yankay, jiusanzhou, and AkihiroSuda

Assets 15

30 Nov 08:58

github-actions

v1.7.1

4692b3e

v1.7.1

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)

Contributors

amrmahdi, yankay, and 7 other contributors

Assets 15

04 Nov 09:05

github-actions

v1.7.0

e674fe7

v1.7.0

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)

Contributors

yankay, kotoji, and 8 other contributors

Assets 15

13 Oct 02:08

github-actions

v1.6.2

e3dc23b

v1.6.2

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)

Contributors

AkihiroSuda

Assets 15

12 Oct 02:37

github-actions

v1.6.1

2752149

v1.6.1

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)

Contributors

yankay, henry118, and 6 other contributors

Assets 15

19 Sep 08:27

github-actions

v1.6.0

5f39d76

v1.6.0

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...

Contributors

metux, webwurst, and 10 other contributors

Assets 15

31 Jul 11:18

github-actions

v1.5.0

b33a58f

v1.5.0

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 -...

Contributors

surenkov, yankay, and 19 other contributors

Assets 15

20 May 14:55

github-actions

v1.4.0

7e8114a

v1.4.0

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)
- fuse-overlayfs was relicensed from GPL-3.0-or-later to GPL-2.0-or-later: containers/fuse-overlayfs#392

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)

Contributors

imeoer, dardelean, and 8 other contributors

Assets 15

14 Apr 06:47

github-actions

v1.3.1

b224b28

v1.3.1

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

Contributors

mook-as, ningziwen, and 4 other contributors

Assets 15

05 Apr 13:13

github-actions

v1.3.0

c6ddd63

v1.3.0

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 fo...

Contributors

manugupt1, adamrehn, and 12 other contributors

Assets 15

Releases: containerd/nerdctl

v1.7.2

Changes

Compatible containerd versions

About the binaries

Minimal

Full

Quick start

Rootful

Rootless

Contributors

v1.7.1

Changes

Compatible containerd versions

About the binaries

Minimal

Full

Quick start

Rootful

Rootless

Contributors

v1.7.0

Changes

Compatible containerd versions

About the binaries

Minimal

Full

Quick start

Rootful

Rootless

Contributors

v1.6.2

Changes

Compatible containerd versions

About the binaries

Minimal

Full

Quick start

Rootful

Rootless

Contributors

v1.6.1

Changes

Compatible containerd versions

About the binaries

Minimal

Full

Quick start

Rootful

Rootless

Contributors

v1.6.0

Changes

Compatible containerd versions

About the binaries

Minimal

Full

Quick start

Rootful

Rootless

Contributors

v1.5.0

Changes

Compatible containerd versions

About the binaries

Minimal

Full

Quick start

Rootful

Rootless

Contributors

v1.4.0

Changes

Compatible containerd versions

About the binaries

Minimal

Full

Quick start

Rootful

Rootless