Changes
- Add
nerdctl run --pid
(#273, thanks to @shishir-a412ed) - Fix copying up initial contents of the mount point directory (#263, thanks to @fahedouch)
- Support bind propagate options for
--volume
(#268, thanks to @ktock) - The Go package
github.com/containerd/nerdctl
was moved togithub.com/containerd/nerdctl/cmd/nerdctl
(#269)- Users using
go install github.com/containerd/nerdctl
will need to change their installation script togo install github.com/containerd/nerdctl/cmd/nerdctl
- Users using
make
or the binary distribution are unaffected
- Users using
- nerdctl-full:
- compile runc as a static binary (#267, #264). Fixes
waiting for init preliminary setup caused: unexpected 123 != 0
error on ARM (lima-vm/lima#79) - update fuse-overlayfs to 1.6 (#265)
- compile runc as a static binary (#267, #264). Fixes
About the binaries
- Minimal (
nerdctl-0.10.0-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-0.10.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-0.10.0-linux-amd64.tar.gz
-rwxr-xr-x root/root 22433792 2021-07-01 09:11 nerdctl
-rwxr-xr-x root/root 14866 2021-07-01 09:10 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 6972 2021-07-01 09:10 containerd-rootless.sh
Full
Extract the archive to a path like
See
/usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-0.10.0-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2021-07-01 09:16 bin/
-rwxr-xr-x 0/0 24806586 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 36016163 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 49082464 2021-05-20 01:02 bin/containerd
-rwxr-xr-x 0/0 9990144 2021-06-24 08:25 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 14866 2021-07-01 09:15 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 6972 2021-07-01 09:15 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 8691712 2021-05-20 01:02 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 35627008 2021-06-02 12:43 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 22680544 2021-05-20 01:02 bin/containerd-stress
-rwxr-xr-x 0/0 19498192 2021-07-01 09:16 bin/ctd-decoder
-rwxr-xr-x 0/0 27247360 2021-05-20 01:02 bin/ctr
-rwxr-xr-x 0/0 28575697 2021-07-01 09:16 bin/ctr-enc
-rwxr-xr-x 0/0 24826128 2021-06-02 12:44 bin/ctr-remote
-rwxr-xr-x 0/0 2462216 2021-07-01 09:16 bin/fuse-overlayfs
-rwxr-xr-x 0/0 22409216 2021-07-01 09:15 bin/nerdctl
-rwxr-xr-x 0/0 9171263 2021-04-15 05:25 bin/rootlessctl
-rwxr-xr-x 0/0 10670565 2021-04-15 05:25 bin/rootlesskit
-rwxr-xr-x 0/0 11427888 2021-07-01 09:15 bin/runc
-rwxr-xr-x 0/0 3658504 2021-07-01 09:16 bin/slirp4netns
-rwxr-xr-x 0/0 33755136 2021-06-02 12:43 bin/stargz-store
drwxr-xr-x 0/0 0 2021-07-01 09:15 lib/
drwxr-xr-x 0/0 0 2021-07-01 09:15 lib/systemd/
drwxr-xr-x 0/0 0 2021-07-01 09:16 lib/systemd/system/
-rw-r--r-- 0/0 1331 2021-07-01 09:16 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1270 2021-07-01 09:15 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2021-07-01 09:16 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2021-07-01 09:16 libexec/
drwxrwxr-x 0/0 0 2021-07-01 09:16 libexec/cni/
-rwxr-xr-x 0/0 4151672 2021-02-05 15:42 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4536104 2021-02-05 15:42 libexec/cni/bridge
-rwxr-xr-x 0/0 10270090 2021-02-05 15:42 libexec/cni/dhcp
-rwxr-xr-x 0/0 4767801 2021-02-05 15:42 libexec/cni/firewall
-rwxr-xr-x 0/0 3357992 2021-02-05 15:42 libexec/cni/flannel
-rwxr-xr-x 0/0 4144106 2021-02-05 15:42 libexec/cni/host-device
-rwxr-xr-x 0/0 3565330 2021-02-05 15:42 libexec/cni/host-local
-rwxr-xr-x 0/0 4288339 2021-02-05 15:42 libexec/cni/ipvlan
-rwxr-xr-x 0/0 2387968 2021-01-19 09:17 libexec/cni/isolation
-rwxr-xr-x 0/0 3530531 2021-02-05 15:42 libexec/cni/loopback
-rwxr-xr-x 0/0 4367216 2021-02-05 15:42 libexec/cni/macvlan
-rwxr-xr-x 0/0 3966455 2021-02-05 15:42 libexec/cni/portmap
-rwxr-xr-x 0/0 4467317 2021-02-05 15:42 libexec/cni/ptp
-rwxr-xr-x 0/0 3701138 2021-02-05 15:42 libexec/cni/sbr
-rwxr-xr-x 0/0 3153330 2021-02-05 15:42 libexec/cni/static
-rwxr-xr-x 0/0 3668289 2021-02-05 15:42 libexec/cni/tuning
-rwxr-xr-x 0/0 4287972 2021-02-05 15:42 libexec/cni/vlan
-rwxr-xr-x 0/0 3759977 2021-02-05 15:42 libexec/cni/vrf
drwxr-xr-x 0/0 0 2021-07-01 09:15 share/
drwxr-xr-x 0/0 0 2021-07-01 09:15 share/doc/
drwxr-xr-x 0/0 0 2021-07-01 09:15 share/doc/nerdctl/
-rw-r--r-- 0/0 37352 2021-07-01 09:10 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2021-07-01 09:15 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 1848 2021-07-01 09:10 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 1982 2021-07-01 09:10 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 2326 2021-07-01 09:10 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 1387 2021-07-01 09:10 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 689 2021-07-01 09:10 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 3710 2021-07-01 09:10 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 4835 2021-07-01 09:10 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2021-07-01 09:16 share/doc/nerdctl-full/
-rw-r--r-- 0/0 803 2021-07-01 09:16 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 4538 2021-07-01 09:16 share/doc/nerdctl-full/SHA256SUMS
Included components
share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v0.10.0
- containerd: v1.5.2
- runc: v1.0.0
- CNI plugins: v0.9.1
- CNI isolation plugin: v0.0.3
- BuildKit: v0.8.3
- Stargz Snapshotter: v0.6.4
- imgcrypt: v1.1.1
- RootlessKit: v0.14.2
- slirp4netns: v1.1.11
- fuse-overlayfs: v1.6
- containerd-fuse-overlayfs: v1.0.3
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.1.11/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 3](https://github.com/containers/fuse-overlayfs/blob/v1.6/COPYING)
- bin/runc (Apache License 2.0) is statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/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/989462715
The sha256sum of the SHA256SUMS file itself is 03db3799fe2238acefb0db580f7d5164279dcb1a1d2d935ff9d272ed56044143
.