Skip to main content
Version: 1.6

Working with Containers

nerdctl is a Docker-compatible CLI for containerd. The primary goal of nerdctl is to facilitate experimenting with cutting-edge features of containerd that are not present in Docker.

Moby is an open-source project that was created by Docker to enable and accelerate software containerization. Components include container build tools, a container registry, orchestration tools, and a runtime, and more. The Docker CLI uses the Moby runtime.

Running Containers

To run a container with the default bridge CNI network (

nerdctl run -it --rm alpine

To build an image using BuildKit:

nerdctl build -t foo /some-dockerfile-directory
nerdctl run -it --rm foo

To build and send output to a local directory using BuiltKit:

nerdctl build -o type=local,dest=. /some-dockerfile-directory

Docker Compose

Docker Compose is a tool for defining and running multi-container Docker applications.

The nerdctl-compose CLI is designed to be compatible with docker-compose:

nerdctl compose up -d
nerdctl compose down

Exposing a Port

To expose port 8000 for a container:

nerdctl run -d -p 8000:80 nginx

You can then access the container via the browser here: http://localhost:8000/.

Note: By default the exposed ports are accessible on all network interfaces on macOS and Linux. However, on Windows, the exposed ports are currently only accessible through the localhost network interface (see issue #1180). As a workaround, you can configure a portproxy on the windows host to expose the port to additional network interfaces.

netsh interface portproxy add v4tov4 listenport=8080 listenaddress= connectport=8080 connectaddress=localhost

Targeting a Kubernetes Namespace

You may also target a Kubernetes namespace with the --namespace parameter with containerd. Please note that docker doesn't use namespaces.

nerdctl --namespace build -t demo:latest /code/demos/rd/anvil-app
nerdctl --namespace ps