Skip to main content

Nerdctl

Dagger can be used with any OCI-compatible container runtime, including nerdctl and finch (which uses nerdctl under the hood).

Prerequisites​

Ensure that nerdctl (or finch) is installed and running on your system:

$ nerdctl info
Client:
Namespace: default
Debug Mode: false
warning

To be able to use the nerdctl backend as unprivileged user, nerdctl must be installed and running on the host system in rootless mode.

Using lima​

To use nerdctl with Dagger via lima, create the following shell script at /usr/local/bin/nerdctl:

#!/bin/sh
lima nerdctl "$@"

Example​

$ nerdctl ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
$ nerdctl core version
v0.18.19
$ nerdctl ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
27d47c3d5a10 registry.dagger.io/engine:v0.18.19 "dagger-entrypoint.s…" 6 days ago Up 4 hours dagger-engine-v0.18.19

Resources​

If you have any questions about additional ways to use nerdctl with Dagger, join our Discord and ask your questions in our help channel.

About nerdctl​

nerdctl is a Docker-compatible tool to manage and run containers.