nerdctl

README

nerdctl: Docker-compatible CLI for containerd

nerdctl is a Docker-compatible CLI for containerd.

Examples

To run a container with the default CNI network (10.4.0.0/16):

# nerdctl run -it --rm alpine

To build an image using BuildKit:

# nerdctl build -t foo .
# nerdctl run -it --rm foo

To list Docker containers:

# nerdctl --namespace moby ps -a

To list Kubernetes containers:

# nerdctl --namespace k8s.io ps -a

Install

Binaries are available for amd64, arm64, and arm-v7: https://github.com/AkihiroSuda/nerdctl/releases

In addition to containerd, the following components should be installed (optional):

• CNI plugins: for internet connectivity.
• BuildKit: for using nerdctl build. BuildKit daemon (buildkitd) needs to be running.

Motivation

The goal of nerdctl is to facilitate experimenting the cutting-edge features of containerd that are not present in Docker.

Such features includes, but not limited to, lazy-pulling and encryption of images.

Also, nerdctl might be potentially useful for debugging Kubernetes clusters, but it is not the primary goal.

Similar tools

• ctr: incompatible with Docker, and not friendly to users
• crictl: incompatible with Docker, not friendly to users, and does not support non-CRI features
• k3c: needs an extra daemon, and does not support non-CRI features
• PouchContainer: needs an extra daemon

Implementation status of Docker-compatible commands and flags

• nerdctl build

  • -t

• nerdctl images

  • -q, --quiet: Only show numeric IDs
  • --no-trunc: Don't truncate output

• nerdctl info

• nerdctl ps

  • -a, --all: Show all containers (default shows just running)
  • --no-trunc: Don't truncate output
  • -q, --quiet: Only display container IDs

• nerdctl pull

• nerdctl rm

  • -f

• nerdctl run

  • -i (WIP: currently -i needs to correspond to -t)
  • -t (WIP: currently -t needs to correspond to -i)
  • -d
  • --restart=(no|always) (WIP: currently "always" requires --network=(host|none))
  • --rm
  • --network=(bridge|host|none)
  • --dns
  • --pull=(always|missing|never)
  • --security-opt seccomp
  • --security-opt apparmor
  • --security-opt no-new-privileges
  • --privileged

• nerdctl version

Lots of commands and flags are currently missing. Pull requests are highly welcome.

Features present in nerdctl but not present in Docker

• Namespacing as in kubectl --namespace=<NS>: nerdctl --namespace=<NS> ps
• Lazy-pulling using Stargz Snapshotter: nerdctl --snapshotter=stargz run

Compiling nerdctl from source

Run make && sudo make install.

Using go get github.com/AkihiroSuda/nerdctl is possible, but unrecommended because it does not fill version strings printed in nerdctl version

Contributing to nerdctl

• Please certify your Developer Certificate of Origin (DCO), by signing off your commit with git commit -s and with your real name.