How to use the Dagger plugin

Run Dagger pipelines and inline scripts from Kestra flows using the Dagger CLI.

Tasks

Commands runs one or more Dagger pipeline expressions — set commands (required list; each entry is passed individually to dagger shell -c). Script runs an inline Dagger script — set script (required; written to a temp file and piped to dagger shell via stdin). Use Script for multi-step pipelines authored inline; use Commands for discrete pipeline calls.

Both tasks default containerImage to curlimages/curl: latest. The Dagger CLI is auto-installed at runtime via the Dagger install script when curl is available, so the default image works without modification. Override containerImage to pin a specific Dagger version or use a custom base image. When using the Process task runner, containerImage is ignored and Dagger must already be installed on the host.

Setup and environment

Use beforeCommands for setup steps that run before the pipeline, and env to pass environment variables. Store credentials such as registry tokens in secrets and reference them from env.

Apply plugin defaults to share runner configuration across tasks.