github containerd/nerdctl v1.6.0
on GitHub

latest releases: v2.0.0-rc.2, v1.7.7, v2.0.0-rc.1...
12 months ago

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

Changes

  • nerdctl push:

  • 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:

  • 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:

  • 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:

Full changes: https://github.com/containerd/nerdctl/milestone/29?closed=1
Thanks to 
@akhramov
@austinvazquez @davidhsingyuchen @fahedouch @gabriel-samfira @metux @ningziwen @testwill @vsiravar @webwurst @yankay

Compatible containerd versions

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

About the binaries

  • Minimal (nerdctl-1.6.0-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-1.6.0-linux-amd64.tar.gz): Includes dependencies such as containerd, runc, and CNI

Minimal

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

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

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

Full

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

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

drwxr-xr-x 0/0               0 2023-09-19 06:59 bin/
-rwxr-xr-x 0/0        27623705 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0        23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0        53353409 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0         3788344 2023-09-19 06:55 bin/bypass4netns
-rwxr-xr-x 0/0         5283840 2023-09-19 06:55 bin/bypass4netnsd
-rwxr-xr-x 0/0        57355480 2023-09-19 06:57 bin/containerd
-rwxr-xr-x 0/0        10432512 2023-05-11 08:23 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           21618 2023-09-19 06:57 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            7187 2023-09-19 06:57 bin/containerd-rootless.sh
-rwxr-xr-x 0/0        12275712 2023-09-19 06:58 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0        59637768 2023-03-08 10:08 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0        20394184 2023-09-19 06:59 bin/ctd-decoder
-rwxr-xr-x 0/0        28830976 2023-09-19 06:57 bin/ctr
-rwxr-xr-x 0/0        29366269 2023-09-19 06:59 bin/ctr-enc
-rwxr-xr-x 0/0        26664136 2023-03-08 10:08 bin/ctr-remote
-rwxr-xr-x 0/0         1785448 2023-09-19 06:59 bin/fuse-overlayfs
-rwxr-xr-x 0/0        83555368 2023-08-08 18:07 bin/ipfs
-rwxr-xr-x 0/0        24539136 2023-09-19 06:57 bin/nerdctl
-rwxr-xr-x 0/0        10113536 2023-05-30 06:31 bin/rootlessctl
-rwxr-xr-x 0/0        11600435 2023-05-30 06:31 bin/rootlesskit
-rwxr-xr-x 0/0        15038440 2023-09-19 06:56 bin/runc
-rwxr-xr-x 0/0         2346328 2023-09-19 06:59 bin/slirp4netns
-rwxr-xr-x 0/0          870496 2023-09-19 06:59 bin/tini
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/systemd/
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/systemd/system/
-rw-r--r-- 0/0            1475 2023-09-19 06:58 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1414 2023-09-19 06:55 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2023-09-19 06:58 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2023-09-19 06:58 libexec/
drwxrwxr-x 0/0               0 2023-09-19 06:58 libexec/cni/
-rwxr-xr-x 0/0         4016001 2023-05-09 19:53 libexec/cni/bandwidth
-rwxr-xr-x 0/0         4531309 2023-05-09 19:53 libexec/cni/bridge
-rwxr-xr-x 0/0        10816051 2023-05-09 19:53 libexec/cni/dhcp
-rwxr-xr-x 0/0         4171248 2023-05-09 19:53 libexec/cni/dummy
-rwxr-xr-x 0/0         4649749 2023-05-09 19:53 libexec/cni/firewall
-rwxr-xr-x 0/0         4059321 2023-05-09 19:53 libexec/cni/host-device
-rwxr-xr-x 0/0         3444776 2023-05-09 19:53 libexec/cni/host-local
-rwxr-xr-x 0/0         4193323 2023-05-09 19:53 libexec/cni/ipvlan
-rwxr-xr-x 0/0         3514598 2023-05-09 19:53 libexec/cni/loopback
-rwxr-xr-x 0/0         4227193 2023-05-09 19:53 libexec/cni/macvlan
-rwxr-xr-x 0/0         3955775 2023-05-09 19:53 libexec/cni/portmap
-rwxr-xr-x 0/0         4348835 2023-05-09 19:53 libexec/cni/ptp
-rwxr-xr-x 0/0         3716095 2023-05-09 19:53 libexec/cni/sbr
-rwxr-xr-x 0/0         2984504 2023-05-09 19:53 libexec/cni/static
-rwxr-xr-x 0/0         4258344 2023-05-09 19:53 libexec/cni/tap
-rwxr-xr-x 0/0         3603365 2023-05-09 19:53 libexec/cni/tuning
-rwxr-xr-x 0/0         4187498 2023-05-09 19:53 libexec/cni/vlan
-rwxr-xr-x 0/0         3754911 2023-05-09 19:53 libexec/cni/vrf
drwxr-xr-x 0/0               0 2023-09-19 06:57 share/
drwxr-xr-x 0/0               0 2023-09-19 06:57 share/doc/
drwxr-xr-x 0/0               0 2023-09-19 06:57 share/doc/nerdctl/
-rw-r--r-- 0/0           12386 2023-09-19 06:47 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2023-09-19 06:47 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2023-09-19 06:47 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2023-09-19 06:47 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            3996 2023-09-19 06:47 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           72895 2023-09-19 06:47 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1846 2023-09-19 06:47 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            5329 2023-09-19 06:47 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2023-09-19 06:47 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            2435 2023-09-19 06:47 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2023-09-19 06:47 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14217 2023-09-19 06:47 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2023-09-19 06:47 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            2439 2023-09-19 06:47 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0           14463 2023-09-19 06:47 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            1748 2023-09-19 06:47 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2936 2023-09-19 06:47 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2596 2023-09-19 06:47 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2023-09-19 06:47 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2023-09-19 06:47 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2023-09-19 06:47 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            5088 2023-09-19 06:47 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0            2003 2023-09-19 06:47 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0           10312 2023-09-19 06:47 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2023-09-19 06:59 share/doc/nerdctl-full/
-rw-r--r-- 0/0            1151 2023-09-19 06:59 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            6300 2023-09-19 06:59 share/doc/nerdctl-full/SHA256SUMS

Included components

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

# nerdctl (full distribution)
- nerdctl: v1.6.0
- containerd: v1.7.6
- runc: v1.1.9
- CNI plugins: v1.3.0
- BuildKit: v0.12.2
- Stargz Snapshotter: v0.14.3
- imgcrypt: v1.1.8
- RootlessKit: v1.1.1
- slirp4netns: v1.2.1
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.6
- Kubo (IPFS): v0.22.0
- Tini: v0.19.0
- buildg: v0.4.1

## License
- bin/slirp4netns:    [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.1/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.22.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)

Quick start

Rootful

$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine

Rootless

$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine

Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .

The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/6232118186

The sha256sum of the SHA256SUMS file itself is 86ae32752c992de4b32161f1ea28962b3010b3757a30732f437c98f72a92fe62 .

Release manager: Akihiro Suda (@AkihiroSuda)

Check out latest releases or
releases around containerd/nerdctl v1.6.0

Don't miss a new nerdctl release

NewReleases is sending notifications on new releases.

Get notifications