Skip to main content

CLI Reference

dagger

A tool to run composable workflows in containers

dagger [options] [subcommand | file...]

Options

      --allow-llm strings            List of URLs of remote modules allowed to access LLM APIs, or 'all' to bypass restrictions for the entire session
-y, --auto-apply Automatically apply changes when a changeset is returned
-c, --command string Execute a dagger shell command
-d, --debug Show debug logs and full verbosity
--eager-runtime load module runtime eagerly
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
-m, --load-module string Use a one-off module (local path or git ref)
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
--model string LLM model to use (e.g., 'claude-sonnet-4-5', 'gpt-4.1')
-E, --no-exit Leave the TUI running after completion
-M, --no-load-module Don't load any module for this command
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger activity - Show recent activity (runs, traces, etc.) for this workspace
  • dagger api - Interact with the Dagger API (advanced)
  • dagger check - Verify your project — tests, linters, type checks, security scans, etc.
  • dagger cloud - Manage Dagger Cloud
  • dagger generate - Generate derived files for your project — code, SDKs, types, docs, etc.
  • dagger install - Install a module into your workspace
  • dagger installed - List installed modules
  • dagger module - Author a module: edit dependencies, engine version, etc.
  • dagger sdk - Install and manage SDKs (the modules that author other modules)
  • dagger search - Search for modules you can install
  • dagger settings - Get or set module settings (use --env for an env overlay)
  • dagger setup - Ensure Dagger is properly set up and operational in the workspace
  • dagger uninstall - Uninstall a module from your workspace
  • dagger up - Run your project's services for local development — databases, APIs, dev servers, etc.
  • dagger update - Refresh installed-module state
  • dagger version - Print dagger version
  • dagger workspace - Inspect or configure your workspace (cwd, remotes, config, etc.)

dagger activity

Show recent activity (runs, traces, etc.) for this workspace

dagger activity

Options

  -a, --all   Show activity from all remotes in the current workspace

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger api

Interact with the Dagger API (advanced)

Synopsis

Every Dagger command — check, up, generate, even install — ultimately runs against a GraphQL API served by the Dagger engine, combining Dagger's core types with schema extensions loaded from modules. The "api" group surfaces direct access for scripting and advanced automation. Most users will never type these commands.

See https://docs.dagger.io/api for the full overview.

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger api call

Call one or more functions, interconnected into a pipeline

dagger api call [options] [function]...

Options

      --allow-llm strings    List of URLs of remote modules allowed to access LLM APIs, or 'all' to bypass restrictions for the entire session
--eager-runtime load module runtime eagerly
-j, --json Present result as JSON
-m, --load-module string Use a one-off module (local path or git ref)
-M, --no-load-module Don't load any module for this command
-o, --output string Save the result to a local file or directory

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger api - Interact with the Dagger API (advanced)

dagger api client

Manage generated API clients

Synopsis

Manage generated API clients for workspace modules.

Generated clients are persistent typed bindings to the API surface exposed by one selected module. Client state is recorded in dagger.toml under the SDK module that generates it.

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger api client init

Initialize a generated API client

Synopsis

Initialize a generated API client at <path>.

<sdk> is an SDK installed in this workspace. Run dagger sdk install <sdk> to add more choices.

The engine resolves <sdk> from dagger.toml, validates that it is installed as an SDK, plans the generated files and workspace config change, then returns a Changeset that the CLI previews and applies through the standard preview/apply flow.

dagger api client init <sdk> <path> <module>

Examples

dagger api client init typescript ./lib/cli .dagger/modules/api

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger api client list

List generated API clients

dagger api client list

Options

      --json   Output the client list in JSON format

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger api exec

Run a command with a connected Dagger API session (DAGGER_SESSION_PORT/TOKEN injected)

Synopsis

Run an external command with a live Dagger API session attached.

DAGGER_SESSION_PORT and DAGGER_SESSION_TOKEN are injected into the command's environment so the command can talk to the engine directly. Progress is rendered live in the TUI.

For example:

jq -n '{query:"{container{id}}"}' | \
dagger api exec sh -c 'curl -s \
-u $DAGGER_SESSION_TOKEN: \
-H "content-type:application/json" \
-d @- \
http://127.0.0.1:$DAGGER_SESSION_PORT/query'
dagger api exec [options] <command>...

Examples

dagger api exec go run main.go
dagger api exec node index.mjs
dagger api exec python main.py

Options

      --cleanup-timeout duration   max duration to wait between SIGTERM and SIGKILL on interrupt (default 10s)
--focus Only show output for focused commands.

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger api - Interact with the Dagger API (advanced)

dagger api functions

List available functions

Synopsis

List available functions in a module.

This is similar to dagger api call --help, but only focused on showing the available functions.

Examples: dagger api functions # List top-level functions in current workspace dagger api functions container # List functions on container dagger -m core api functions # List core functions dagger -W github.com/acme/ws api functions # List top-level functions in explicit workspace dagger -W github.com/acme/ws api functions container from

dagger api functions [options] [function]...

Options

      --allow-llm strings    List of URLs of remote modules allowed to access LLM APIs, or 'all' to bypass restrictions for the entire session
--eager-runtime load module runtime eagerly
-m, --load-module string Use a one-off module (local path or git ref)

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger api - Interact with the Dagger API (advanced)

dagger api query

Send API queries to a dagger engine

Synopsis

Send API queries to a dagger engine.

When no document file is provided, reads query from standard input.

Can optionally provide the GraphQL operation name if there are multiple queries in the document.

dagger api query [options] [operation]

Examples

dagger api query <<EOF
{
container {
from(address:"hello-world") {
withExec(args:["/hello"]) {
stdout
}
}
}
}
EOF

Options

      --allow-llm strings    List of URLs of remote modules allowed to access LLM APIs, or 'all' to bypass restrictions for the entire session
--doc string Read query from file (defaults to reading from stdin)
--eager-runtime load module runtime eagerly
-m, --load-module string Use a one-off module (local path or git ref)
-M, --no-load-module Don't load any module for this command
--var strings List of query variables, in key=value format
--var-json string Query variables in JSON format (overrides --var)

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger api - Interact with the Dagger API (advanced)

dagger check

Verify your project — tests, linters, type checks, security scans, etc.

Synopsis

Verify your project — tests, linters, type checks, security scans, etc.

Examples: dagger check # Run all checks dagger check -l # List all available checks dagger check go:lint # Run the go:lint check and any subchecks dagger check --skip '**e2e' # Run all checks except those matching '**e2e' dagger -W github.com/acme/ws check go:lint # Run check(s) against explicit workspace

dagger check [options] [pattern...]

Options

      --allow-llm strings    List of URLs of remote modules allowed to access LLM APIs, or 'all' to bypass restrictions for the entire session
--eager-runtime load module runtime eagerly
--failfast Cancel remaining checks on first failure
--generate Only run generate-as-checks, skip annotated check functions
-l, --list List available checks
-m, --load-module string Use a one-off module (local path or git ref)
--no-generate Only run annotated check functions, skip generate-as-checks
--no-past Disable past Cloud Checks lookup
--past Only replay past Cloud Checks results
--run Run checks even when past Cloud Checks results are replayed
--skip stringArray Skip checks matching the specified patterns

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger cloud

Manage Dagger Cloud

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud billing

Manage Dagger Cloud billing

dagger cloud billing

Options

      --json   Print JSON output

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud billing manage

Open the billing portal for a Dagger Cloud org

dagger cloud billing manage [org]

Options

      --open   Open the billing portal in a browser

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--json Print JSON output
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud billing plans

List Dagger Cloud plans available at signup

dagger cloud billing plans

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--json Print JSON output
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud check

Manage Cloud-side automated checks for this workspace

dagger cloud check

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud check list

List Cloud-side checks for this workspace

dagger cloud check list

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud check off

Disable a Cloud-side check (by name; defaults to the workspace remote's default check)

dagger cloud check off [name]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud check on

Enable a Cloud-side check (by name; defaults to the workspace remote's default check)

dagger cloud check on [name]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud check status

Show the status of a Cloud-side check (by name; defaults to the workspace remote's default check)

dagger cloud check status [name]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud integration

Manage Dagger Cloud integration providers

dagger cloud integration

Options

      --json   Print JSON output

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud integration create

Create a new integration of the given provider type

dagger cloud integration create <provider>

Examples

dagger cloud integration create github

Options

      --open   Open the setup URL in a browser

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--json Print JSON output
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud integration list

List configured integrations (optionally filtered by provider type)

dagger cloud integration list [type]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--json Print JSON output
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud integration rm

Remove a configured integration

dagger cloud integration rm <id>

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--json Print JSON output
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud login

Log in to Dagger Cloud

dagger cloud login [options] [org]

Options

      --switch-account   Choose a different Dagger Cloud account

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud logout

Log out from Dagger Cloud

dagger cloud logout

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud org

Manage Dagger Cloud organizations

dagger cloud org [flags]

Options

      --json   Print JSON output

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud org info

Show Dagger Cloud organization status

dagger cloud org info [org] [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--json Print JSON output
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud org list

List Dagger Cloud organizations

dagger cloud org list [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--json Print JSON output
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger cloud org use

Select the current Dagger Cloud organization

dagger cloud org use <org> [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--json Print JSON output
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger generate

Generate derived files for your project — code, SDKs, types, docs, etc.

Synopsis

Generate derived files for your project — code, SDKs, types, docs, etc.

Examples: dagger generate # Generate all assets dagger generate -l # List all available generators dagger generate go:bin # Generate by selecting the generator function dagger -W github.com/acme/ws generate go:bin # Generate against explicit workspace

dagger generate [options] [pattern...]

Options

  -l, --list   List available generators

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger install

Install a module into your workspace

Synopsis

Install a module into the current workspace.

If no workspace config is selected, this creates one at the workspace root first. Use --here to create the workspace config at the workspace cwd instead.

dagger install [options] <module>

Examples

dagger install github.com/shykes/daggerverse/hello@v0.3.0

Options

      --here          Write workspace config at the selected workspace cwd
-n, --name string Name to use for the module in the workspace. Defaults to the name of the module being installed.

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger installed

List installed modules

dagger installed

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger module

Author a module: edit dependencies, engine version, etc.

Synopsis

Author a module: edit dependencies, engine version, etc.

Operates on the dagger-module.toml reachable from the current directory.

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module deps

Manage this module's dependencies

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module deps add

Add one or more dependencies to the module

dagger module deps add <module>... [flags]

Examples

dagger module deps add github.com/dagger/dagger/modules/wolfi

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module deps list

List the current module's dependencies

dagger module deps list [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module deps rm

Remove one or more dependencies from the module

dagger module deps rm <name>... [flags]

Examples

dagger module deps rm wolfi

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module engine

Manage this module's required engine version

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module engine require

Set the module's required engine version

dagger module engine require <version> [flags]

Examples

dagger module engine require v0.21.0

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module engine require-current

Set the module's required engine version to the currently running engine version

dagger module engine require-current [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module engine require-latest

Set the module's required engine version to the latest released version

dagger module engine require-latest [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module engine required

Print the module's required engine version

dagger module engine required [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger module init

Initialize a new module in the current workspace

Synopsis

Initialize a new module in the workspace.

<sdk> is an SDK installed in this workspace. Run dagger sdk install <sdk> to add more choices.

For example, after dagger sdk install go, run dagger module init go myapp.

The CLI is a thin wrapper around the engine's Workspace.moduleInit. The engine validates that <sdk> is installed as an SDK in dagger.toml, plans the workspace changes, and returns a Changeset that the CLI previews and applies through the standard changeset apply flow.

What the engine does (atomically, in one Changeset):

  1. Resolves <sdk> to an installed SDK entry and requires its as-sdk marker.
  2. Generates the new module's dagger-module.toml + SDK-emitted source scaffold at <path>.
  3. Records [[modules.<sdk-module>.as-sdk.modules]] authoring entry for <path>.
  4. When --path is the default (.dagger/modules/<name>), also installs the new module as [modules.<name>] so it's callable here.

--path defaults to .dagger/modules/<name>. Custom paths skip the [modules.<name>] install (the user is managing workspace layout explicitly).

dagger module init <sdk> <name> [flags]

Examples

dagger module init go myapp

Options

      --path string   Module path relative to the workspace root (default: .dagger/modules/<name>)

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger module - Author a module: edit dependencies, engine version, etc.

dagger module sdk

Run SDK-specific commands against this module's SDK

Synopsis

Run SDK-specific commands against the current module's SDK.

Reads the SDK from the module's dagger-module.toml and dispatches through "dagger call <sdk>". Available subcommands depend entirely on the SDK in use — the wrapper is a thin forwarder.

Examples: dagger module sdk python-version 3.13 dagger module sdk go-mod-tidy dagger module sdk python-version --help # SDK function help (dispatched) dagger module sdk --help # this wrapper's help

dagger module sdk <subcommand> [args...] [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger module - Author a module: edit dependencies, engine version, etc.

dagger sdk

Install and manage SDKs (the modules that author other modules)

Synopsis

Install and manage SDKs.

SDKs are workspace modules whose role is to scaffold/codegen other things: new Dagger modules (dagger module init) or typed clients against the Dagger API (dagger api client init). An install becomes an SDK when added through this group — dagger sdk install go installs [modules.go-sdk] with [modules.go-sdk.as-sdk] name = "go" so dagger module init go / dagger api client init go dispatch through that SDK.

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger sdk client-options

Show SDK-specific flags accepted by dagger api client init <sdk>

Synopsis

Print the SDK-specific flags dagger api client init <sdk> accepts, introspected from the SDK's initClient function.

Requires the SDK to implement the initClient capability.

dagger sdk client-options <sdk> [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger sdk - Install and manage SDKs (the modules that author other modules)

dagger sdk install

Install an SDK and mark it

Synopsis

Install an SDK into the current workspace and mark it with the [modules.<name>.as-sdk] table.

Alias resolution: dagger sdk install go resolves "go" via the embedded sdks.json registry to github.com/dagger/go-sdk. The workspace install name is the canonical ref basename (go-sdk), and the user-facing name is persisted as [modules.go-sdk.as-sdk] name = "go". Direct refs work too: dagger sdk install github.com/foo/sdk is installed as [modules.sdk] by basename.

Generic dagger install <ref> does NOT mark anything as an SDK. The marker is opt-in via this verb.

dagger sdk install [options] <name-or-ref> [flags]

Examples

dagger sdk install go

Options

      --here          Write to the workspace config directory at the workspace cwd
-n, --name string Override the workspace install name (defaults to the registry repo basename, or the basename of a direct ref)

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger sdk - Install and manage SDKs (the modules that author other modules)

dagger sdk list

List installed SDKs

Synopsis

List installs in the current workspace that carry the [modules.<name>.as-sdk] marker.

The M and C columns count workspace-local modules and clients authored under each SDK (the entries in [[modules.<name>.as-sdk.modules]] and [[modules.<name>.as-sdk.clients]]).

dagger sdk list [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger sdk - Install and manage SDKs (the modules that author other modules)

dagger sdk module-options

Show SDK-specific flags accepted by dagger module init <sdk>

Synopsis

Print the SDK-specific flags dagger module init <sdk> <name> accepts, introspected from the SDK's initModule function.

Requires the SDK to implement the initModule capability.

dagger sdk module-options <sdk> [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger sdk - Install and manage SDKs (the modules that author other modules)

Discover SDKs in the SDK registry

Synopsis

List entries in the embedded SDK registry (sdks.json).

With no query, prints all known SDKs and their aliases. With a query, filters by case-insensitive substring on name, description, alias, or repo.

dagger sdk search [query] [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger sdk - Install and manage SDKs (the modules that author other modules)

dagger sdk uninstall

Remove an SDK install

Synopsis

Remove an SDK install from the current workspace.

Refuses if anything is authored under the SDK (entries in [[modules.<name>.as-sdk.modules]] or [[modules.<name>.as-sdk.clients]]). Pass --force to override and remove anyway; the authored module/client files are left on disk untouched, only the workspace entries go away.

dagger sdk uninstall [options] <name> [flags]

Examples

dagger sdk uninstall go

Options

      --force   Remove even if modules or clients are authored under this SDK
--here Write to the workspace config directory at the workspace cwd

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger sdk - Install and manage SDKs (the modules that author other modules)

Search for modules you can install

Synopsis

Search the module registry by name or description.

With no query, lists all known modules.

dagger search [query]

Examples

dagger search wolfi

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger settings

Get or set module settings (use --env for an env overlay)

dagger settings [module] [key] [value]

Options

      --here   Write workspace config at the selected workspace cwd

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger setup

Ensure Dagger is properly set up and operational in the workspace

Synopsis

Ensure Dagger is properly set up and operational in the workspace.

Walks through three steps, each prompted independently:

  1. Cloud login — authenticate with Dagger Cloud.
  2. Workspace migrate — convert any legacy dagger.json projects to the current workspace format.
  3. Recommended modules — suggest modules to install based on files present in the workspace.

Idempotent: safe to run anytime. No-ops what's already in good shape. Each step can be skipped at the prompt. With --auto-apply, all steps are applied without prompting. In non-interactive mode (no TTY) the default is to skip steps that would mutate state.

dagger setup

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger uninstall

Uninstall a module from your workspace

Synopsis

Uninstall a module from the current workspace, removing it from dagger.toml.

dagger uninstall [options] <module>

Examples

dagger uninstall hello

Options

      --here   Write workspace config at the selected workspace cwd

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger up

Run your project's services for local development — databases, APIs, dev servers, etc.

Synopsis

Run your project's services for local development — databases, APIs, dev servers, etc.

Examples: dagger up # Start all services dagger up -l # List all available services dagger up web # Start only the 'web' service

dagger up [options] [pattern...]

Options

  -l, --list   List available services

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger update

Refresh installed-module state

Synopsis

Refresh installed-module state.

Refreshes entries already recorded in dagger.lock.

dagger update

Examples

"dagger update"

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger version

Print dagger version

dagger version

Options

      --check   Check for updates

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger - A tool to run composable workflows in containers

dagger workspace

Inspect or configure your workspace (cwd, remotes, config, etc.)

Synopsis

Inspect or configure your workspace.

A workspace is a project configured to use Dagger — a directory holding a dagger.toml that records installed modules, environment overlays, and settings. Most commands (install, check, generate, up, settings, ...) operate on the workspace reachable from the current directory. The -W flag selects a different workspace (local path or git ref); --env applies a named overlay; dagger.toml is the source of truth.

Run with no subcommand to print a digest of workspace state (cwd, root, current remote, installed modules summary).

dagger workspace

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

dagger workspace config

Get or set workspace configuration

Synopsis

Get or set workspace configuration values in dagger.toml.

With no arguments, prints the full configuration. With one argument, prints the value at the given key. With two arguments, sets the value at the given key.

With --env, reads show the effective env-applied view while writes target that environment's overlay. Explicit env.* keys always address raw overlay storage.

Local module source values are stored relative to dagger.toml.

dagger workspace config [key] [value] [flags]

Options

      --here   Write workspace config at the selected workspace cwd

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger workspace - Inspect or configure your workspace (cwd, remotes, config, etc.)

dagger workspace config-file

Print the selected workspace config file

dagger workspace config-file [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger workspace - Inspect or configure your workspace (cwd, remotes, config, etc.)

dagger workspace cwd

Print the workspace cwd

dagger workspace cwd [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger workspace - Inspect or configure your workspace (cwd, remotes, config, etc.)

dagger workspace remote

Print the selectable remote address for the current workspace

dagger workspace remote [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger workspace - Inspect or configure your workspace (cwd, remotes, config, etc.)

dagger workspace remotes

List selectable remote workspace addresses

dagger workspace remotes [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger workspace - Inspect or configure your workspace (cwd, remotes, config, etc.)

dagger workspace root

Print the workspace root

dagger workspace root [flags]

Options inherited from parent commands

  -y, --auto-apply                   Automatically apply changes when a changeset is returned
-d, --debug Show debug logs and full verbosity
--env string Apply the named workspace environment overlay
-i, --interactive Spawn a terminal on container exec failure
--interactive-command string Change the default command for interactive mode (default "/bin/sh")
--lock string Lock lookup mode (disabled, live, pinned, frozen). Defaults to disabled.
-E, --no-exit Leave the TUI running after completion
--org string Dagger Cloud org name for Cloud-scoped commands
--progress string Progress output format (auto, plain, tty, dots, logs) (default "auto")
-q, --quiet count Reduce verbosity (show progress, but clean up at the end)
-s, --silent Do not show progress at all
-v, --verbose count Increase verbosity (use -vv or -vvv for more)
-w, --web Open trace URL in a web browser
-W, --workspace string Select the workspace location to load from (local path or git ref)
--x-release string Run an experimental release from a Dagger git ref

SEE ALSO

  • dagger workspace - Inspect or configure your workspace (cwd, remotes, config, etc.)