Skip to main content
Version: 0.70.0


Kurtosis can be used to run a Starlark script or a runnable package in an enclave.

A single Starlark script can be ran with:

kurtosis run

Adding the --dry-run flag will print the changes without executing them.

A Kurtosis package on your local machine can be run with:

kurtosis run /path/to/package/on/your/machine

A runnable Kurtosis package published to GitHub can be run like so:

kurtosis run

If you want to run a non-main branch, tag or commit use the following syntax kurtosis run[email protected]

Arguments can be provided to a Kurtosis package (either local or from GitHub) by passing a JSON-serialized object with args argument, which is the second positional argument you pass to kurtosis run like:

# Local package
kurtosis run /path/to/package/on/your/machine '{"company":"Kurtosis"}'

# GitHub package
kurtosis run '{"company":"Kurtosis"}'

This command has options available to customize its execution:

  1. The --dry-run flag can be used to print the changes proposed by the script without executing them
  2. The --parallelism flag can be used to specify to what degree of parallelism certain commands can be run. For example: If the script contains add_services and is run with --parallelism 100, up to 100 services will be run at one time.
  3. The --enclave-id flag can be used to instruct Kurtosis to run the script inside the specified enclave or create a new enclave (with the given enclave identifier) if one does not exist. If this flag is not used, Kurtosis will create a new enclave with an auto-generated name, and run the script or package inside it.
  4. The --with-subnetworks flag can be used to enable subnetwork capabilties within the specified enclave that the script or package is instructed to run within. This flag is false by default.
  5. The --verbosity flag can be used to set the verbosity of the command output. The options include BRIEF, DETAILED, or EXECUTABLE. If unset, this flag defaults to BRIEF for a concise and explicit output. Use DETAILED to display the exhaustive list of arguments for each command. Meanwhile, EXECUTABLE will generate executable Starlark instructions.