> For the complete documentation index, see [llms.txt](https://docs.helmut.de/helmut4-releases/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helmut.de/helmut4-releases/v4.13.0/helmut4-components/streamdesigner/nodes/actions/misc-21/os-5/bash-execute-action.md).

# Bash Execute Action

### Bash Execute Action

The Bash Execute Action node executes a Unix Bash command on the system running the stream.

It can be used for command-line operations such as retrieving system information, running scripts, managing files and folders, starting external tools, or calling other Unix-compatible applications.

This node is intended for Unix-based systems such as Linux and macOS.

<figure><img src="/files/XKMtGnuEvFpunqBSFyjB" alt="" width="350"><figcaption><p>Bash Execute Action</p></figcaption></figure>

***

#### Configurable Settings

**Async**

Enables or disables asynchronous execution.

**Command**

The Bash command to execute.

Helmut wildcards can be used within the command.

Example:

```
hostname
```

Another example:

```
cp "{job.source}" "{helmut.variable.root-helmut}/Asset/{path.name.{job.source}}"
```

Paths containing spaces or special characters should be enclosed in quotation marks.

Multiple commands can be combined using standard shell operators.

Example:

```
mkdir -p "/Volumes/Target/Assets" && cp "{job.source}" "/Volumes/Target/Assets/"
```

***

#### Node Result

The command output is returned as the node result and can be accessed using [{node.result.?}](/helmut4-releases/v4.13.0/helmut4-components/streamdesigner/wildcards/result-or-return-wildcards-2/node-result.md) or [{stream.last\_result}](/helmut4-releases/v4.13.0/helmut4-components/streamdesigner/wildcards/result-or-return-wildcards-2/stream-last_result.md)

For example, when executing:

```
hostname
```

the result contains the hostname returned by the system.

The returned value can be used by subsequent nodes for conditions, logging, temporary variables, or further processing.

***

#### Typical Usage

```
Command:
hostname
```

Another example:

```
Command:
du -sh "{project.parent}"
```

This returns the calculated size of the specified project directory.

***

#### Important Notes

* The command must be compatible with the Bash environment on the executing system.
* Required command-line tools must be installed and available to the executing user.
* The executing user must have the necessary permissions for all referenced files, folders, and applications.
* Quote paths that contain spaces or special characters.
* Be careful when inserting wildcards containing user-provided values into shell commands.
* The node does not automatically escape or validate command arguments.
* Use the Bash Execute With Progress Action instead when a long-running command should update the related job with progress information.