Skip to main content

Run Bash Script

Run Bash Script executes a .sh script through a Command Runner policy. The script path must resolve under that runner's Allowed Paths.

It differs from Run Command in taking a script path rather than an executable — otherwise the argument, environment and output behaviour is the same.

The activity has four tabs: Configuration, Arguments, Environment, and Output.

Configuration

FieldRequiredDescription
NameOptionalName of the component.
DescriptionOptionalDescription of the component.
Command RunnerOptionalThe Command Runner policy resource that gates this execution.
Script PathOptionalPath to the .sh script; must resolve under the runner's Allowed Paths.
Working DirectoryOptionalMust be under the runner's Allowed Paths. Defaults to the first Allowed Paths entry.
Standard InputOptionalText written to the process stdin, which is then closed.

Script Path, Working Directory, and Standard Input each support mapped and vault-backed values.

Arguments

FieldRequiredDescription
ArgumentsOptionalArguments passed after the script path, each a discrete array element.

Environment

FieldRequiredDescription
Environment OverridesOptionalPer-run environment variables applied on top of the runner's environment.

Values are mapping and vault capable.

Output

The activity returns a scriptOutput object.

FieldData TypeDescription
exitCodeIntegerProcess exit code.
stdoutStringCaptured standard output.
stderrStringCaptured standard error.
durationMsIntegerRun duration in milliseconds.
timedOutBooleanWhether the run exceeded Max Runtime (seconds) on the Command Runner.
truncatedBooleanWhether output exceeded Max Output Bytes (per stream) and was cut short.