[⬇️ Download] [📖 Command reference] [📚 Additional documents]

nerdctl is a Docker-compatible CLI for containerd.

✅ Same UI/UX as docker

✅ Supports Docker Compose (nerdctl compose up)

✅ Supports rootless mode

✅ Supports lazy-pulling (Stargz)

✅ Supports encrypted images (ocicrypt)

nerdctl is a non-core sub-project of containerd.

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

# nerdctl run -it --rm alpine

To build an image using BuildKit:

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

To run containers from docker-compose.yaml:

# nerdctl compose -f ./examples/compose-wordpress/docker-compose.yaml up

See also ./examples/compose-wordpress.

To list Kubernetes containers:

# nerdctl --namespace k8s.io ps -a

To launch rootless containerd:

$ containerd-rootless-setuptool.sh install

To run a container with rootless containerd:

$ nerdctl run -d -p 8080:80 --name nginx nginx:alpine

See ./docs/rootless.md.

Binaries are available here: https://github.com/containerd/nerdctl/releases

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

• CNI plugins: for using nerdctl run.
• CNI isolation plugin: for isolating bridge networks (nerdctl network create)
• BuildKit: for using nerdctl build. BuildKit daemon (buildkitd) needs to be running.
• RootlessKit and slirp4netns: for Rootless mode
  • RootlessKit needs to be v0.10.0 or later. v0.14.1 or later is recommended.
  • slirp4netns needs to be v0.4.0 or later. v1.1.7 or later is recommended.

These dependencies are included in nerdctl-full-<VERSION>-<OS>-<ARCH>.tar.gz, but not included in nerdctl-<VERSION>-<OS>-<ARCH>.tar.gz.

Lima project provides Linux virtual machines with built-in integration for nerdctl.

$ brew install lima
$ limactl start
$ lima nerdctl run -d --name nginx -p 127.0.0.1:8080:80 nginx:alpine

NOTE: ARM Mac requires installing a patched version of QEMU, see Lima documentation.

• Linux containers: Known to work on WSL2
• Windows containers: WIP, see PR #197

To run containerd and nerdctl inside Docker:

docker build -t nerdctl .
docker run -it --rm --privileged nerdctl

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.

Note that competing with Docker is not the goal of nerdctl. Those cutting-edge features are expected to be eventually available in Docker as well.

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

Major:

• Lazy-pulling using Stargz Snapshotter: nerdctl --snapshotter=stargz run .
• Running encrypted images using ocicrypt (imgcrypt)

Minor:

• Namespacing: nerdctl --namespace=<NS> ps . (NOTE: All Kubernetes containers are in the k8s.io containerd namespace regardless to Kubernetes namespaces)
• Exporting Docker/OCI dual-format archives: nerdctl save .
• Importing OCI archives as well as Docker archives: nerdctl load .
• Specifying a non-image rootfs: nerdctl run -it --rootfs <ROOTFS> /bin/sh . The CLI syntax conforms to Podman convention.
• Connecting a container to multiple networks at once: nerdctl run --net foo --net bar

Trivial:

• Inspecting raw OCI config: nerdctl container inspect --mode=native .

• ctr: incompatible with Docker CLI, and not friendly to users. Notably, ctr lacks the equivalents of the following Docker CLI commands:

  • docker run -p <PORT>
  • docker run --restart=always --net=bridge
  • docker pull with ~/.docker/config.json and credential helper binaries such as docker-credential-ecr-login
  • docker logs

• crictl: incompatible with Docker CLI, not friendly to users, and does not support non-CRI features

• k3c v0.2 (abandoned): needs an extra daemon, and does not support non-CRI features

• Rancher Kim (nee k3c v0.3): needs Kubernetes, and only focuses on image management commands such as kim build and kim push

• PouchContainer (abandoned?): needs an extra daemon

nerdctl is a containerd non-core sub-project, licensed under the Apache 2.0 license. As a containerd non-core sub-project, you will find the:

• Project governance,
• Maintainers,
• and Contributing guidelines

information in our containerd/project repository.

Run make && sudo make install.

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

Run go test -v ./pkg/...

Run go test -exec sudo -v ./cmd/nerdctl/... after make && sudo make install.

For testing rootless mode, -exec sudo is not needed.

To run tests in a container:

docker build -t test-integration --target test-integration .
docker run -t --rm --privileged test-integration

Run go test -exec sudo -v ./cmd/nerdctl/... -args test.target=docker to ensure that the test suite is compatible with Docker.

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

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

🐳 = Docker compatible

🤓 = nerdctl specific

Unlisted docker CLI flags are unimplemented yet in nerdctl CLI. It does not necessarily mean that the corresponding features are missing in containerd.

• Run & Exec
  • 🐳 nerdctl run
  • 🐳 nerdctl exec
• Container management
  • 🐳 nerdctl ps
  • 🐳 nerdctl inspect
  • 🐳 nerdctl logs
  • 🐳 nerdctl port
  • 🐳 nerdctl rm
  • 🐳 nerdctl stop
  • 🐳 nerdctl start
  • 🐳 nerdctl wait
  • 🐳 nerdctl kill
  • 🐳 nerdctl pause
  • 🐳 nerdctl unpause
• Build
  • 🐳 nerdctl build
  • 🐳 nerdctl commit
• Image management
  • 🐳 nerdctl images
  • 🐳 nerdctl pull
  • 🐳 nerdctl push
  • 🐳 nerdctl load
  • 🐳 nerdctl save
  • 🐳 nerdctl tag
  • 🐳 nerdctl rmi
  • 🐳 nerdctl image inspect
  • 🤓 nerdctl image convert
• Registry
  • 🐳 nerdctl login
  • 🐳 nerdctl logout
• Network management
  • 🐳 nerdctl network create
  • 🐳 nerdctl network ls
  • 🐳 nerdctl network inspect
  • 🐳 nerdctl network rm
• Volume management
  • 🐳 nerdctl volume create
  • 🐳 nerdctl volume ls
  • 🐳 nerdctl volume inspect
  • 🐳 nerdctl volume rm
• Namespace management
  • 🤓 nerdctl namespace ls
• System
  • 🐳 nerdctl events
  • 🐳 nerdctl info
  • 🐳 nerdctl version
• Stats
  • 🐳 nerdctl top
• Shell completion
  • 🤓 nerdctl completion bash
• Compose
  • 🐳 nerdctl compose
  • 🐳 nerdctl compose up
  • 🐳 nerdctl compose logs
  • 🐳 nerdctl compose build
  • 🐳 nerdctl compose down
• Global flags
• Unimplemented Docker commands
• Additional documents

Run a command in a new container.

Usage: nerdctl run [OPTIONS] IMAGE [COMMAND] [ARG...]

Basic flags:

• 🐳 -i, --interactive: Keep STDIN open even if not attached"
• 🐳 -t, --tty: Allocate a pseudo-TTY
  • ⚠️ WIP: currently -t requires -i, and conflicts with -d
• 🐳 -d, --detach: Run container in background and print container ID
• 🐳 --restart=(no|always): Restart policy to apply when a container exits
  • Default: "no"
  • ⚠️ No support for on-failure and unless-stopped
• 🐳 --rm: Automatically remove the container when it exits
• 🐳 --pull=(always|missing|never): Pull image before running
  • Default: "missing"
• 🐳 --pid=(host): PID namespace to use

Network flags:

• 🐳 --net, --network=(bridge|host|none|<CNI>): Connect a container to a network
  • Default: "bridge"
  • 🤓 Unlike Docker, this flag can be specified multiple times (--net foo --net bar)
• 🐳 -p, --publish: Publish a container's port(s) to the host
• 🐳 --dns: Set custom DNS servers
• 🐳 -h, --hostname: Container host name
• 🐳 --add-host: Add a custom host-to-IP mapping (host:ip)

Cgroup flags:

• 🐳 --cpus: Number of CPUs
• 🐳 --cpu-shares: CPU shares (relative weight)
• 🐳 --cpuset-cpus: CPUs in which to allow execution (0-3, 0,1)
• 🐳 --memory: Memory limit
• 🐳 --pids-limit: Tune container pids limit
• 🐳 --cgroupns=(host|private): Cgroup namespace to use
  • Default: "private" on cgroup v2 hosts, "host" on cgroup v1 hosts
• 🐳 --device: Add a host device to the container

User flags:

• 🐳 -u, --user: Username or UID (format: <name|uid>[:<group|gid>])

Security flags:

• 🐳 --security-opt seccomp=<PROFILE_JSON_FILE>: specify custom seccomp profile
• 🐳 --security-opt apparmor=<PROFILE>: specify custom AppArmor profile
• 🐳 --security-opt no-new-privileges: disallow privilege escalation, e.g., setuid and file capabilities
• 🐳 --cap-add=<CAP>: Add Linux capabilities
• 🐳 --cap-drop=<CAP>: Drop Linux capabilities
• 🐳 --privileged: Give extended privileges to this container

Runtime flags:

• 🐳 --runtime: Runtime to use for this container, e.g. "crun", or "io.containerd.runsc.v1".
• 🐳 --sysctl: Sysctl options, e.g "net.ipv4.ip_forward=1"

Volume flags:

• 🐳 -v, --volume: Bind mount a volume

Rootfs flags:

• 🐳 --read-only: Mount the container's root filesystem as read only
• 🤓 --rootfs: The first argument is not an image but the rootfs to the exploded container. Corresponds to Podman CLI.

Env flags:

• 🐳 --entrypoint: Overwrite the default ENTRYPOINT of the image
• 🐳 -w, --workdir: Working directory inside the container
• 🐳 -e, --env: Set environment variables
• 🐳 --env-file: Set environment variables from file

Metadata flags:

• 🐳 --name: Assign a name to the container
• 🐳 -l, --label: Set meta data on a container
• 🐳 --label-file: Read in a line delimited file of labels
• 🐳 --cidfile: Write the container ID to the file
• 🤓 --pidfile: file path to write the task's pid. The CLI syntax conforms to Podman convention.

Shared memory flags:

• 🐳 --shm-size: Size of /dev/shm

GPU flags:

• 🐳 --gpus: GPU devices to add to the container ('all' to pass all GPUs). Please see also ./docs/gpu.md for details.

Other docker run flags are on plan but unimplemented yet.

Usage:  docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

Run a command in a new container

Options:
      --add-host list                  Add a custom host-to-IP mapping (host:ip)
  -a, --attach list                    Attach to STDIN, STDOUT or STDERR
      --blkio-weight uint16            Block IO (relative weight), between 10 and 1000, or 0 to disable (default 0)
      --blkio-weight-device list       Block IO weight (relative device weight) (default [])
      --cap-add list                   Add Linux capabilities
      --cap-drop list                  Drop Linux capabilities
      --cgroup-parent string           Optional parent cgroup for the container
      --cgroupns string                Cgroup namespace to use (host|private)
                                       'host':    Run the container in the Docker host's cgroup namespace
                                       'private': Run the container in its own private cgroup namespace
                                       '':        Use the cgroup namespace as configured by the
                                                  default-cgroupns-mode option on the daemon (default)
      --cidfile string                 Write the container ID to the file
      --cpu-period int                 Limit CPU CFS (Completely Fair Scheduler) period
      --cpu-quota int                  Limit CPU CFS (Completely Fair Scheduler) quota
      --cpu-rt-period int              Limit CPU real-time period in microseconds
      --cpu-rt-runtime int             Limit CPU real-time runtime in microseconds
  -c, --cpu-shares int                 CPU shares (relative weight)
      --cpus decimal                   Number of CPUs
      --cpuset-cpus string             CPUs in which to allow execution (0-3, 0,1)
      --cpuset-mems string             MEMs in which to allow execution (0-3, 0,1)
  -d, --detach                         Run container in background and print container ID
      --detach-keys string             Override the key sequence for detaching a container
      --device list                    Add a host device to the container
      --device-cgroup-rule list        Add a rule to the cgroup allowed devices list
      --device-read-bps list           Limit read rate (bytes per second) from a device (default [])
      --device-read-iops list          Limit read rate (IO per second) from a device (default [])
      --device-write-bps list          Limit write rate (bytes per second) to a device (default [])
      --device-write-iops list         Limit write rate (IO per second) to a device (default [])
      --disable-content-trust          Skip image verification (default true)
      --dns list                       Set custom DNS servers
      --dns-option list                Set DNS options
      --dns-search list                Set custom DNS search domains
      --domainname string              Container NIS domain name
      --entrypoint string              Overwrite the default ENTRYPOINT of the image
  -e, --env list                       Set environment variables
      --env-file list                  Read in a file of environment variables
      --expose list                    Expose a port or a range of ports
      --gpus gpu-request               GPU devices to add to the container ('all' to pass all GPUs)
      --group-add list                 Add additional groups to join
      --health-cmd string              Command to run to check health
      --health-interval duration       Time between running the check (ms|s|m|h) (default 0s)
      --health-retries int             Consecutive failures needed to report unhealthy
      --health-start-period duration   Start period for the container to initialize before starting health-retries countdown (ms|s|m|h) (default 0s)
      --health-timeout duration        Maximum time to allow one check to run (ms|s|m|h) (default 0s)
      --help                           Print usage
  -h, --hostname string                Container host name
      --init                           Run an init inside the container that forwards signals and reaps processes
  -i, --interactive                    Keep STDIN open even if not attached
      --ip string                      IPv4 address (e.g., 172.30.100.104)
      --ip6 string                     IPv6 address (e.g., 2001:db8::33)
      --ipc string                     IPC mode to use
      --isolation string               Container isolation technology
      --kernel-memory bytes            Kernel memory limit
  -l, --label list                     Set meta data on a container
      --label-file list                Read in a line delimited file of labels
      --link list                      Add link to another container
      --link-local-ip list             Container IPv4/IPv6 link-local addresses
      --log-driver string              Logging driver for the container
      --log-opt list                   Log driver options
      --mac-address string             Container MAC address (e.g., 92:d0:c6:0a:29:33)
  -m, --memory bytes                   Memory limit
      --memory-reservation bytes       Memory soft limit
      --memory-swap bytes              Swap limit equal to memory plus swap: '-1' to enable unlimited swap
      --memory-swappiness int          Tune container memory swappiness (0 to 100) (default -1)
      --mount mount                    Attach a filesystem mount to the container
      --name string                    Assign a name to the container
      --network network                Connect a container to a network
      --network-alias list             Add network-scoped alias for the container
      --no-healthcheck                 Disable any container-specified HEALTHCHECK
      --oom-kill-disable               Disable OOM Killer
      --oom-score-adj int              Tune host's OOM preferences (-1000 to 1000)
      --pid string                     PID namespace to use
      --pids-limit int                 Tune container pids limit (set -1 for unlimited)
      --platform string                Set platform if server is multi-platform capable
      --privileged                     Give extended privileges to this container
  -p, --publish list                   Publish a container's port(s) to the host
  -P, --publish-all                    Publish all exposed ports to random ports
      --pull string                    Pull image before running ("always"|"missing"|"never") (default "missing")
      --read-only                      Mount the container's root filesystem as read only
      --restart string                 Restart policy to apply when a container exits (default "no")
      --rm                             Automatically remove the container when it exits
      --runtime string                 Runtime to use for this container
      --security-opt list              Security Options
      --shm-size bytes                 Size of /dev/shm
      --sig-proxy                      Proxy received signals to the process (default true)
      --stop-signal string             Signal to stop a container (default "SIGTERM")
      --stop-timeout int               Timeout (in seconds) to stop a container
      --storage-opt list               Storage driver options for the container
      --sysctl map                     Sysctl options (default map[])
      --tmpfs list                     Mount a tmpfs directory
  -t, --tty                            Allocate a pseudo-TTY
      --ulimit ulimit                  Ulimit options (default [])
  -u, --user string                    Username or UID (format: <name|uid>[:<group|gid>])
      --userns string                  User namespace to use
      --uts string                     UTS namespace to use
  -v, --volume list                    Bind mount a volume
      --volume-driver string           Optional volume driver for the container
      --volumes-from list              Mount volumes from the specified container(s)
  -w, --workdir string                 Working directory inside the container

Run a command in a running container.

Usage: nerdctl exec [OPTIONS] CONTAINER COMMAND [ARG...]

Flags:

• 🐳 -i, --interactive: Keep STDIN open even if not attached
• 🐳 -t, --tty: Allocate a pseudo-TTY
  • ⚠️ WIP: currently -t requires -i, and conflicts with -d
• 🐳 -d, --detach: Detached mode: run command in the background
• 🐳 -w, --workdir: Working directory inside the container
• 🐳 -e, --env: Set environment variables
• 🐳 --privileged: Give extended privileges to the command

Unimplemented docker exec flags: --detach-keys, --env-file, --user

List containers.

Usage: nerdctl ps [OPTIONS]

Flags:

• 🐳 -a, --all: Show all containers (default shows just running)
• 🐳 --no-trunc: Don't truncate output
• 🐳 -q, --quiet: Only display container IDs
• 🐳 --format: Format the output using the given Go template, e.g, {{json .}}

Unimplemented docker ps flags: --filter, --last, --size

Display detailed information on one or more containers.

Usage: nerctl inspect [OPTIONS] NAME|ID [NAME|ID...]

Flags:

• 🤓 --mode=(dockercompat|native): Inspection mode. "native" produces more information.
• 🐳 --format: Format the output using the given Go template, e.g, {{json .}}

Unimplemented docker inspect flags: --size, --type

Fetch the logs of a container.

⚠️ Currently, only containers created with nerdctl run -d are supported.

Usage: nerctl logs [OPTIONS] CONTAINER

Flags:

• 🐳 --f, --follow: Follow log output
• 🐳 --since: Show logs since timestamp (e.g. 2013-01-02T13:23:37Z) or relative (e.g. 42m for 42 minutes)
• 🐳 --until: Show logs before a timestamp (e.g. 2013-01-02T13:23:37Z) or relative (e.g. 42m for 42 minutes)
• 🐳 -t, --timestamps: Show timestamps
• 🐳 -n, --tail: Number of lines to show from the end of the logs (default "all")

Unimplemented docker logs flags: --details

List port mappings or a specific mapping for the container.

Usage: nerdctl port CONTAINER [PRIVATE_PORT[/PROTO]]

Remove one or more containers.

Usage: nerdctl rm [OPTIONS] CONTAINER [CONTAINER...]

Flags:

• 🐳 -f, --force: Force the removal of a running|paused|unknown container (uses SIGKILL)
• 🐳 -v, --volumes: Remove anonymous volumes associated with the container

Unimplemented docker rm flags: --link

Stop one or more running containers.

Usage: nerdctl stop [OPTIONS] CONTAINER [CONTAINER...]

Unimplemented docker stop flags: --time

Start one or more running containers.

Usage: nerdctl start [OPTIONS] CONTAINER [CONTAINER...]

Unimplemented docker start flags: --attach, --checkpoint, --checkpoint-dir, --detach-keys, --interactive

Block until one or more containers stop, then print their exit codes.

Usage: nerdctl wait CONTAINER [CONTAINER...]

Kill one or more running containers.

Usage: nerdctl kill [OPTIONS] CONTAINER [CONTAINER...]

Flags:

• 🐳 -s, --signal: Signal to send to the container (default: "KILL")

Pause all processes within one or more containers.

Usage: nerdctl pause CONTAINER [CONTAINER...]

Unpause all processes within one or more containers.

Usage: nerdctl unpause CONTAINER [CONTAINER...]

Build an image from a Dockerfile.

ℹ️ Needs buildkitd to be running.

Usage: nerdctl build [OPTIONS] PATH

Flags:

• 🤓 --buildkit-host=<BUILDKIT_HOST>: BuildKit address
• 🐳 -t, --tag: Name and optionally a tag in the 'name:tag' format
• 🐳 -f, --file: Name of the Dockerfile
• 🐳 --target: Set the target build stage to build
• 🐳 --build-arg: Set build-time variables
• 🐳 --no-cache: Do not use cache when building the image
• 🐳 --progress=(auto|plain|tty): Set type of progress output (auto, plain, tty). Use plain to show container output
• 🐳 --secret: Secret file to expose to the build: id=mysecret,src=/local/secret
• 🐳 --ssh: SSH agent socket or keys to expose to the build (format: default|<id>[=<socket>|<key>[,<key>]])

Unimplemented docker build flags: --add-host, --cache-from, --iidfile, --label, --network, --platform, --quiet, --squash

Create a new image from a container's changes

Usage: nerdctl commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]

Flags:

• 🐳 -a, --author: Author (e.g., "nerdctl contributor [email protected]")
• 🐳 -m, --message: Commit message

Unimplemented docker commit flags: --change, --pause

List images

Usage: nerdctl images [OPTIONS] [REPOSITORY[:TAG]]

Flags:

• 🐳 -q, --quiet: Only show numeric IDs
• 🐳 --no-trunc: Don't truncate output
• 🐳 --format: Format the output using the given Go template, e.g, {{json .}}

Unimplemented docker images flags: --all, --digests, --filter

Pull an image from a registry.

Usage: nerdctl pull [OPTIONS] NAME[:TAG|@DIGEST]

Unimplemented docker pull flags: --all-tags, --disable-content-trust (default true), --platform, --quiet

Push an image to a registry.

Usage: nerdctl push [OPTIONS] NAME[:TAG]

Unimplemented docker push flags: --all-tags, --disable-content-trust (default true), --quiet

Load an image from a tar archive or STDIN.

🤓 Supports both Docker Image Spec v1.2 and OCI Image Spec v1.0.

Usage: nerdctl load [OPTIONS]

Flags:

• 🐳 -i, --input: Read from tar archive file, instead of STDIN

Unimplemented docker load flags: --quiet

Save one or more images to a tar archive (streamed to STDOUT by default)

🤓 The archive implements both Docker Image Spec v1.2 and OCI Image Spec v1.0.

Usage: nerdctl save [OPTIONS] IMAGE [IMAGE...]

Flags:

• 🐳 -o, --output: Write to a file, instead of STDOUT

Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE.

Usage: nerdctl tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]

Remove one or more images

Usage: nerdctl rmi [OPTIONS] IMAGE [IMAGE...]

Unimplemented docker rmi flags: --force, --no-prune

Display detailed information on one or more images.

Usage: nerctl image inspect [OPTIONS] NAME|ID [NAME|ID...]

Flags:

• 🤓 --mode=(dockercompat|native): Inspection mode. "native" produces more information.
• 🐳 --format: Format the output using the given Go template, e.g, {{json .}}

Convert an image format.

e.g., nerdctl image convert --estargz --oci example.com/foo:orig example.com/foo:esgz

Usage: nerdctl image convert [OPTIONS] SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]

Flags:

• --estargz : convert legacy tar(.gz) layers to eStargz for lazy pulling. Should be used in conjunction with '--oci'
• --estargz-record-in=<FILE> : read ctr-remote optimize --record-out=<FILE> record file. ⚠️ This flag is experimental and subject to change.
• --estargz-compression-level=<LEVEL>: eStargz compression level (default: 9)
• --estargz-chunk-size=<SIZE> : eStargz chunk size
• --uncompress : convert tar.gz layers to uncompressed tar layers
• --oci : convert Docker media types to OCI media types
• --platform=<PLATFORM> : convert content for a specific platform
• --all-platforms : convert content for all platforms (default: false)

Log in to a Docker registry.

Usage: nerdctl login [OPTIONS] [SERVER]

Flags:

• 🐳 -u, --username: Username
• 🐳 -p, --password: Password
• 🐳 --password-stdin: Take the password from stdin

Log out from a Docker registry

Usage: nerdctl logout [SERVER]

Create a network

ℹ️ To isolate CNI bridge, CNI isolation plugin needs to be installed.

Usage: nerdctl network create [OPTIONS] NETWORK

Flags:

• 🐳 --subnet: Subnet in CIDR format that represents a network segment, e.g. "10.5.0.0/16"
• 🐳 --label: Set metadata on a network

Unimplemented docker network create flags: --attachable, --aux-address, --config-from, --config-only, --driver, --gateway, --ingress, --internal, --ip-range, --ipam-driver, --ipam-opt, --ipv6, --opt, --scope

List networks

Usage: nerdctl network ls [OPTIONS]

Flags:

• 🐳 -q, --quiet: Only display network IDs
• 🐳 --format: Format the output using the given Go template, e.g, {{json .}}

Unimplemented docker network ls flags: --filter, --no-trunc

Display detailed information on one or more networks

Usage: nerdctl network inspect [OPTIONS] NETWORK [NETWORK...]

Unimplemented docker network inspect flags: --format, --verbose

Remove one or more networks

Usage: nerdctl network rm NETWORK [NETWORK...]

Create a volume

Usage: nerdctl volume create [OPTIONS] [VOLUME]

Flags:

• 🐳 --label: Set metadata for a volume

Unimplemented docker volume create flags: --driver, --opt

List volumes

Usage: nerdctl volume ls [OPTIONS]

Flags:

• 🐳 -q, --quiet: Only display volume names
• 🐳 --format: Format the output using the given Go template, e.g, {{json .}}

Unimplemented docker volume ls flags: --filter

Display detailed information on one or more volumes

Usage: nerdctl volume inspect [OPTIONS] VOLUME [VOLUME...]

Unimplemented docker volume inspect flags: --format

Remove one or more volumes

Usage: nerdctl volume rm [OPTIONS] VOLUME [VOLUME...]

• 🐳 -f, --force: Force the removal of one or more volumes
  • ⚠️ WIP: currently, volumes are always forcibly removed, even when --force is not specified.

List containerd namespaces such as "default", "moby", or "k8s.io".

Usage: nerdctl namespace ls [OPTIONS]

Flags:

• -q, --quiet: Only display namespace names

Get real time events from the server.

⚠️ The output format is not compatible with Docker.

Usage: nerdctl events [OPTIONS] Flags:

• 🐳 --format: Format the output using the given Go template, e.g, {{json .}}

Unimplemented docker events flags: --filter, --since, --until

Display system-wide information

Usage: nerdctl info [OPTIONS]

Flags:

• 🐳 -f, --format: Format the output using the given Go template, e.g, {{json .}}

Show the nerdctl version information

Usage: nerdctl version [OPTIONS]

Flags:

• 🐳 -f, --format: Format the output using the given Go template, e.g, {{json .}}

Display the running processes of a container.

Usage: nerdctl top CONTAINER [ps OPTIONS]

Show bash completion.

Usage: add the following line to ~/.bash_profile:

source <(nerdctl completion bash)

Compose

Usage: nerdctl compose [OPTIONS] [COMMAND]

Flags:

• 🐳 -f, --file: Specify an alternate compose file
• 🐳 -p, --project-name: Specify an alternate project name

Create and start containers

Usage: nerdctl compose up [OPTIONS] [SERVICE...]

Flags:

• 🐳 -d, --detach: Detached mode: Run containers in the background
• 🐳 --no-color: Produce monochrome output
• 🐳 --no-log-prefix: Don't print prefix in logs
• 🐳 --build: Build images before starting containers.

Unimplemented docker-compose up flags: --quiet-pull, --no-deps, --force-recreate, --always-recreate-deps, --no-recreate, --no-start, --abort-on-container-exit, --attach-dependencies, --timeout, --renew-anon-volumes, --remove-orphans, --exit-code-from, --scale

Create and start containers

Usage: nerdctl compose logs [OPTIONS]

Flags:

• 🐳 --no-color: Produce monochrome output
• 🐳 --no-log-prefix: Don't print prefix in logs
• 🐳 --timestamps: Show timestamps
• 🐳 --tail: Number of lines to show from the end of the logs

Build or rebuild services.

Usage: nerdctl compose build [OPTIONS]

Flags:

• 🐳 --build-arg: Set build-time variables for services
• 🐳 --no-cache: Do not use cache when building the image
• 🐳 --progress: Set type of progress output (auto, plain, tty)

Unimplemented docker-compose build flags: --compress, --force-rm, --memory, --no-rm, --parallel, --pull, --quiet

Remove containers and associated resources

Usage: nerdctl compose up [OPTIONS] [SERVICE...]

Flags:

• 🐳 -v, --volumes: Remove named volumes declared in the volumes section of the Compose file and anonymous volumes attached to containers

Unimplemented docker-compose down flags: --rmi, --remove-orphans, --timeout

• 🤓 -a, --address: containerd address, optionally with "unix://" prefix
• 🐳 -H, --host: Docker-compatible alias for -a, --address
• 🤓 -n, --namespace: containerd namespace
• 🤓 --snapshotter: containerd snapshotter
• 🤓 --cni-path: CNI binary path (default: /opt/cni/bin) [$CNI_PATH]
• 🤓 --cni-netconfpath: CNI netconf path (default: /etc/cni/net.d) [$NETCONFPATH]
• 🤓 --data-root: nerdctl data root, e.g. "/var/lib/nerdctl"
• 🤓 --cgroup-manager=(cgroupfs|systemd|none): cgroup manager
  • Default: "systemd" on cgroup v2 (rootful & rootless), "cgroupfs" on v1 rootful, "none" on v1 rootless
• 🤓 --insecure-registry: skips verifying HTTPS certs, and allows falling back to plain HTTP

Container management:

• docker create

• docker attach

• docker cp

• docker diff

• docker rename

• docker container prune

• docker checkpoint *

Stats:

• docker stats

Image:

• docker export and docker import

• docker history

• docker image prune

• docker trust *

• docker manifest *

Network management:

• docker network connect
• docker network disconnect
• docker network prune

Registry:

• docker search

Compose:

• docker-compose config|create|events|exec|images|kill|pause|port|ps|pull|push|restart|rm|run|scale|start|stop|top|unpause

Others:

• docker system df
• docker system prune
• docker context
• Swarm commands are unimplemented and will not be implemented: docker swarm|node|service|config|secret|stack *
• Plugin commands are unimplemented and will not be implemented: docker plugin *

• ./docs/compose.md: Compose
• ./docs/dir.md: Directory layout (/var/lib/nerdctl)
• ./docs/gpu.md: Using GPUs inside containers
• ./docs/registry.md: Registry authentication (~/.docker/config.json)
• ./docs/rootless.md: Rootless mode
• ./docs/stargz.md: Lazy-pulling using Stargz Snapshotter
• ./docs/ocicrypt.md: Running encrypted images