> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/external-application.md).

# Command-line (external application)

Configure Command-line (external application) entries in Remote Desktop Manager, including the command to run, parameters, run as, and execution mode.

This article details the many settings and options available for ***Command-line (external application)*** session entries in Remote Desktop Manager.

{% hint style="info" %}
On macOS and Linux, the application always opens in an external window, and the ***Window selector*** setting is not supported.
{% endhint %}

<table data-header-hidden><thead><tr><th width="200"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Name</strong></td><td>The name of the entry.</td></tr><tr><td><strong>Folder</strong></td><td>The folder where the entry is located.</td></tr><tr><td><strong>Display</strong></td><td><p>How the entry opens:</p><ul><li><strong>External</strong> — Opens the application in its own window.</li><li><strong>Embedded (tabbed)</strong> — Opens the application in a tab of the main window.</li><li><strong>Undocked</strong> — Opens the tab in a separate window that can be moved and resized freely.</li></ul><p>On macOS and Linux, only <em><strong>External</strong></em> is offered and the list is locked. With <em><strong>External</strong></em> or <em><strong>Undocked</strong></em>, a list next to <em><strong>Display</strong></em> selects the virtual desktop where the window opens. With <em><strong>Undocked</strong></em>, another list selects the monitor.</p></td></tr><tr><td><strong>Host</strong></td><td>Where the host of the entry comes from. When the host comes from a linked or inherited host, the <em><strong>Host</strong></em> field of the <em><strong>Host and credentials</strong></em> tab is disabled.</td></tr><tr><td><strong>Credentials</strong></td><td>How the credentials of the entry are provided. Select a credential mode from the list. When the credentials do not come from the entry itself, the <em><strong>Username</strong></em>, <em><strong>Domain</strong></em>, and <em><strong>Password</strong></em> fields of the <em><strong>Host and credentials</strong></em> tab are disabled.</td></tr></tbody></table>

### General

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Run</strong></td><td>The application to start. Enter its path or click the browse button to select it. Required.</td></tr><tr><td><strong>Window selector</strong></td><td>Select a window that is already open to fill in the <em><strong>Run</strong></em> field with its application.</td></tr><tr><td><strong>Arguments</strong></td><td>The arguments passed to the application.</td></tr><tr><td><strong>Assign file icon to session</strong></td><td>Click this link to use the icon of the application file set in the <em><strong>Run</strong></em> field as the icon of the entry.</td></tr><tr><td><strong>Process name</strong></td><td>The name of the process started by the application. Click <em><strong>Set default process name</strong></em> to use the file name of the application. Use the default process name for the application to be listed in the opened sessions.</td></tr><tr><td><strong>Embedded wait time (ms)</strong></td><td>The time to wait before embedding the application window, from 0 to 50000 milliseconds.</td></tr><tr><td><strong>Change default working directory</strong></td><td>Start the application in another working directory. Select the folder in the field below the checkbox.</td></tr></tbody></table>

### Host and credentials

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td>The host passed to the application. Enter a host name or IP address, or choose one from the list.</td></tr><tr><td><strong>Username</strong></td><td>The username passed to the application.</td></tr><tr><td><strong>Domain</strong></td><td>The domain of the username.</td></tr><tr><td><strong>Password</strong></td><td>The password passed to the application. Unavailable when the <em><strong>Disable password saving in vaults</strong></em> system setting is enabled.</td></tr></tbody></table>

Use the `$USERNAME$`, `$DOMAIN$`, `$HOST$`, and `$PASSWORD$` variables in your parameters to insert these values.

### Parameters

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td>The name of the parameter. Each row shows the token to use in the <em><strong>Run</strong></em> field, such as <code>{1}</code> for the first parameter. Click the name to rename the parameter in the <em><strong>Rename</strong></em> window. The list starts with five parameters. Click <em><strong>Add</strong></em> to add a parameter, or <em><strong>Delete</strong></em> to remove the last added parameter. The delete button of a row, shown when its <em><strong>Type</strong></em> is not <em><strong>Unused</strong></em>, clears the value of the parameter, sets its <em><strong>Type</strong></em> to <em><strong>Unused</strong></em> and restores its default name.</td></tr><tr><td><strong>Type</strong></td><td><p>The type of the parameter:</p><ul><li><strong>Unused</strong></li><li><strong>Text</strong></li><li><strong>Secured</strong></li><li><strong>Env. variable</strong></li></ul></td></tr><tr><td><strong>Default value</strong></td><td>The value of the parameter. A <em><strong>Secured</strong></em> parameter hides its value. Unavailable when the <em><strong>Type</strong></em> is <em><strong>Unused</strong></em>.</td></tr><tr><td><strong>Prompt for parameters on open</strong></td><td>Ask for the parameter values each time the entry opens.</td></tr><tr><td><strong>Example in Run field</strong></td><td>Shows how to use the parameter tokens in the <em><strong>Run</strong></em> field. Click <em><strong>View command</strong></em> to display the command with the parameter values inserted. The button is disabled when a <em><strong>Secured</strong></em> parameter has a value and the user is not allowed to view sensitive information.</td></tr></tbody></table>

### Run as

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Run as administrator</strong></td><td>Start the application with administrator privileges. Disables the credential settings below, including <em><strong>Net only</strong></em>.</td></tr><tr><td><strong>Run as mode</strong></td><td><p>How the application is started under other credentials:</p><ul><li><strong>Default (ShellExecute)</strong></li><li><strong>GSudo</strong></li></ul></td></tr><tr><td><strong>Credentials</strong></td><td><p>The credentials used to start the application:</p><ul><li><strong>None</strong></li><li><strong>Current session</strong></li><li><strong>Username and password</strong></li><li><strong>Linked</strong> — Select the vault in the <em><strong>Vault</strong></em> list, then select the credential entry.</li><li><strong>My personal credentials</strong></li><li><strong>My privileged account</strong></li></ul><p>With <em><strong>My personal credentials</strong></em> and <em><strong>My privileged account</strong></em>, click the edit button to modify them.</p></td></tr><tr><td><strong>Username</strong></td><td>The username used to start the application. Available with <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Domain</strong></td><td>The domain of the username. Available with <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Password</strong></td><td>The password used to start the application. Available with <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Always ask for password</strong></td><td>Ask for the password each time the entry opens. Disables the <em><strong>Password</strong></em> field. Available with <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Credential</strong></td><td>The credential entry to use. Available with <em><strong>Linked</strong></em>.</td></tr><tr><td><strong>Entry name</strong></td><td>The name of the credential entry to find in each user's user vault. Available with <em><strong>Linked</strong></em> when the user vault is selected in the <em><strong>Vault</strong></em> list for an entry in a shared vault.</td></tr><tr><td><strong>Net only</strong></td><td>Use the credentials for network access only. Available when <em><strong>Credentials</strong></em> is not <em><strong>None</strong></em>.</td></tr></tbody></table>

### Advanced

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Execution mode</strong></td><td><p>How the application runs:</p><ul><li><strong>Default</strong></li><li><strong>Keep command-line open</strong></li><li><strong>Capture output</strong></li></ul><p>With <em><strong>Capture output</strong></em>, a second list sets where the output goes: <em><strong>Default</strong></em> or <em><strong>To file</strong></em>. With <em><strong>To file</strong></em>, enter the path of the output file. The path is required.</p></td></tr><tr><td><strong>Wait for the application to exit (Remote Desktop Manager will be unavailable)</strong></td><td>Wait until the application closes before Remote Desktop Manager can be used again. With <em><strong>Capture output</strong></em>, this option is selected and cannot be cleared.</td></tr><tr><td><strong>Use Shell Execute</strong></td><td>Start the application through the operating system shell. Available when the <em><strong>Credentials</strong></em> of the <em><strong>Run as</strong></em> tab is <em><strong>None</strong></em>.</td></tr><tr><td><strong>Force "cmd /c" (advanced)</strong></td><td>Start the application through <code>cmd /c</code>. Available when the <em><strong>Credentials</strong></em> of the <em><strong>Run as</strong></em> tab is not <em><strong>None</strong></em>.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/external-application.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
