> 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/ssh-terminal.md).

# SSH terminal

This topic describes all available options specific to this entry. Each chapter represents a tab in the options menu.

{% hint style="info" %}
The following properties can be configured when creating or editing the entry.
{% endhint %}

<table data-header-hidden><thead><tr><th width="122.79998779296875"></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. A folder can be selected by clicking the arrow or the three dots to open the <em><strong>Folder</strong></em> window. To create a new folder, click on the plus (<em><strong>+</strong></em>) icon.</td></tr><tr><td><strong>Display</strong></td><td>How the session is displayed. <em><strong>Embedded (tabbed)</strong></em> means that the remote connection is open within the same window as the other tabs or entries. Each connection has its own tab, making it easy to switch between them. An <em><strong>undocked</strong></em> display refers to the session window being detached from the main application. It allows you to move and resize the remote session window freely on your desktop.</td></tr><tr><td><strong>Host</strong></td><td><em><strong>Host configured</strong></em> lets you select the host. <em><strong>Linked (vault)</strong></em> indicates that the host for the entry is linked to a host entry. <em><strong>Inherited</strong></em> is used when the host is inherited from a higher-level or parent entry.</td></tr><tr><td><strong>Credentials</strong></td><td><ul><li><em><strong>Username and password</strong></em>: You will set the username and password in the <em><strong>General</strong></em> tab.</li><li><em><strong>Linked (vault)</strong></em>: Links to credentials available in the current shared vault. To use this feature, users must have the <em><strong>View</strong></em> permission on the entry.</li><li><em><strong>Inherited</strong></em>: Inheritance means that credentials will automatically be passed down from a higher-level entry to lower-level entries that inherit from it.</li><li><em><strong>My personal credentials</strong></em>: These credentials are not entry specific but are instead taken from the option under <em><strong>File</strong></em> – <em><strong>My account settings</strong></em> – <em><strong>Local credentials</strong></em> – <em><strong>My personal credentials</strong></em>.</li><li><em><strong>None</strong></em>: Remote Desktop Manager will not send credentials to the entry.</li><li><em><strong>Find by name (user vault)</strong></em>: Searches for the name of an entry in the user vault.</li><li><em><strong>My privileged account</strong></em>: These credentials are not entry specific but are instead taken from the option under <em><strong>File</strong></em> – <em><strong>My account settings</strong></em> – <em><strong>Local credentials</strong></em> – <em><strong>My privileged account</strong></em>.</li></ul></td></tr></tbody></table>

### General

![](https://cdnweb.devolutions.net/docs/RDMW0027_2024_2.png)

<table data-header-hidden><thead><tr><th width="218.79998779296875"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Host</strong></td><td>The field contains the host name. Clicking on the ellipsis button opens the <em><strong>Computer list</strong></em> menu. Clicking on <em><strong>Default</strong></em> opens the <em><strong>Port</strong></em> menu. The <em><strong>Port generator...</strong></em> button can generate ports according to a list of parameters.</td></tr><tr><td><strong>Username</strong></td><td>This entry's login credentials.</td></tr><tr><td><strong>Password</strong></td><td>This entry's login credentials.</td></tr><tr><td><strong>Password prompt string</strong></td><td>A string used if a server has a different login process (this field is optional).</td></tr><tr><td><strong>OTP prompt string</strong></td><td>A string used to know when to send the OTP (this field is optional).</td></tr><tr><td><strong>Use smartcard</strong></td><td>Uses the smartcard.</td></tr><tr><td><strong>Certificate method</strong></td><td>The method used to fetch the smartcard credentials.</td></tr><tr><td><strong>PIN</strong></td><td>The smartcard PIN.</td></tr></tbody></table>

### SSH key

#### General

![](https://cdnweb.devolutions.net/docs/RDMW0028_2024_2.png)

<table data-header-hidden><thead><tr><th width="142.7999267578125"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Entry type</strong></td><td><p>The source of the SSH key. Choose between:</p><ul><li><strong>No private key</strong></li><li><strong>File (local)</strong>, which lets you choose a path to a local <code>.key</code> file.</li><li><strong>Embedded data</strong>, which lets you manually enter a private key (or generate one via the <strong>SSH key generator</strong>).</li><li><strong>Linked (vault)</strong>, which lets you choose an SSH key entry from which to retrieve a key. To use this feature, users must have the <strong>View</strong>permission on the entry.</li><li><strong>Linked (external</strong> <strong>vault)</strong>, which allows you choose an SSH key entry in a external vault from which to retrieve a key. To use this feature, users must have the <strong>View</strong>permission on the entry.</li><li><strong>My personal SSH key</strong>, which uses the SSH key set in <strong>File</strong>– <strong>My account settings</strong> – <strong>My personal SSH key</strong>, under <strong>Local credentials</strong>.</li><li><strong>Find by name (user vault)</strong>, which lets you enter the name of a specific SSH key entry within the current user vault from which to retrieve a key.</li><li><strong>Privileged account</strong>, which lets you choose a PAM account from a list previously set up in Devolutions Server.</li></ul></td></tr><tr><td><strong>Vault</strong></td><td>The dropdown can be used to select an SSH key. The ellipsis button opens a window to browse the current vault for SSH keys (this field is only available if the <strong>Entry type</strong> is <strong>Linked (vault)</strong>).</td></tr><tr><td><strong>Passphrase</strong></td><td>The passphrase used to decrypt the key.</td></tr><tr><td><strong>File</strong></td><td>This field points to the SSH key file (this field is only available if the <strong>Entry type</strong> is <strong>File (local)</strong>).</td></tr><tr><td><strong>Private key</strong></td><td>Select or generate a private key file (this field is only for <strong>Embedded data</strong> and the key is saved in Remote Desktop Manager).</td></tr></tbody></table>

#### Certificate

![](https://cdnweb.devolutions.net/docs/RDMW0029_2024_2.png)

| **SETTINGS**      | **DESCRIPTION**                         |
| ----------------- | --------------------------------------- |
| **File (local)**  | Select a local certificate file.        |
| **Embedded data** | Store the certificate in the SSH entry. |

### Proxy

![](https://cdnweb.devolutions.net/docs/RDMW0030_2024_2.png)

<table data-header-hidden><thead><tr><th width="170.79998779296875"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Proxy mode</strong></td><td>The <em><strong>Link</strong></em> mode points to a <em><strong>Proxy Tunnel</strong></em> entry. The <em><strong>Custom</strong></em> mode sets up a custom proxy with the same settings as a proxy tunnel.</td></tr></tbody></table>

* Wildcards, such as asterisks, which are interpreted as any number of characters (including 0), and question marks, each of which represents a single character.
* Leading point notation, according to which ".domain.com" equals "\*.domain.com".

### SSH gateway

![](https://cdnweb.devolutions.net/docs/RDMW0031_2024_2.png)

<table data-header-hidden><thead><tr><th width="173.199951171875"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Gateway mode</strong></td><td>The <em><strong>Custom</strong></em> mode lets you configure an SSH gateway. The <em><strong>Linked</strong></em> mode picks from an already existing SSH gateway.</td></tr></tbody></table>

### Post login

![](https://cdnweb.devolutions.net/docs/RDMW0032_2024_2.png)

<table data-header-hidden><thead><tr><th width="191.5999755859375"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Delay</strong></td><td>A set delay between every executed command.</td></tr><tr><td><strong>Automatic {ENTER} after command</strong></td><td>An automatic linefeed will be added in between every command.</td></tr><tr><td><strong>Commands</strong></td><td><p>Contains a list of command configurations. Clicking the <strong>New</strong> or <strong>Edit</strong> button will bring up the <strong>Macro edit</strong> window with:</p><ul><li>The <strong>Command</strong> field (supports variables)</li><li>The <strong>Expected prompt</strong> (when RDM sees this value it will send this command)</li><li>The <strong>Timeout</strong> for the <strong>Expected prompt</strong> option</li></ul></td></tr></tbody></table>

### Before close

![](https://cdnweb.devolutions.net/docs/RDMW0033_2024_2.png)

<table data-header-hidden><thead><tr><th width="220.39996337890625"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Delay</strong></td><td>A set delay between every executed command.</td></tr><tr><td><strong>Automatic </strong><kbd><strong>Enter</strong></kbd><strong> after command</strong></td><td>An automatic linefeed will be added in between every command.</td></tr><tr><td><strong>Commands</strong></td><td>5 command lines, followed by the <em><strong>More commands</strong></em> field to add additional commands.</td></tr></tbody></table>

### Terminal

![](https://cdnweb.devolutions.net/docs/RDMW0034_2024_2.png)

#### Configuration

<table data-header-hidden><thead><tr><th width="297.199951171875"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Override terminal type</strong></td><td>The terminal will be handled differently if the string in this field is detected.</td></tr><tr><td><strong>Encoding</strong></td><td>Changes character encoding.</td></tr><tr><td><strong>Auto wrap</strong></td><td>Enable or disable auto wrap.</td></tr><tr><td><strong>Local echo</strong></td><td>Enable or disable local echo. The <em><strong>Auto</strong></em> option lets the server decide.</td></tr><tr><td><strong>Initial keypad mode</strong></td><td>How the terminal behaves with the keypad.</td></tr><tr><td><strong>Disable application keypad mode</strong></td><td>Disables the app keypad.</td></tr><tr><td><strong>Cursor type</strong></td><td>Changes the UI cursor type.</td></tr><tr><td><strong>Cursor blink</strong></td><td>Turns the cursor blink on or off.</td></tr><tr><td><strong>Cursor blink rate</strong></td><td>Delay between every cursor blink.</td></tr><tr><td><strong>Reset scroll on display</strong></td><td>Enable or disable scroll reset.</td></tr><tr><td><strong>Reset scroll on keypress</strong></td><td>Enable or disable scroll reset.</td></tr><tr><td><strong>Force Non-destructive backspace</strong></td><td>Enable or disable non-destructive backspace.</td></tr><tr><td><strong>Implicit Carriage return in Linefeed</strong></td><td>Adds a carriage return with every linefeed.</td></tr><tr><td><strong>Implicit linefeed in carriage return</strong></td><td>Adds a linefeed with every carriage return.</td></tr><tr><td><strong>Max scrollback lines</strong></td><td>The maximum number of displayed lines.</td></tr><tr><td><strong>Double-click delimiters</strong></td><td>Delimits what is selected in the terminal with a character or a string when double-clicking.</td></tr></tbody></table>

#### Display

![](https://cdnweb.devolutions.net/docs/RDMW0035_2024_2.png)

<table data-header-hidden><thead><tr><th width="243.60003662109375"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><em><strong>Allow remote-controlled window title changing</strong></em></td><td>Changes the entry tab name depending on what the server feeds.</td></tr><tr><td><em><strong>Colors</strong></em></td><td>Allows color overriding.</td></tr><tr><td><strong>Font</strong></td><td>Allows font overriding.</td></tr><tr><td><strong>Terminal size</strong></td><td>The <em><strong>Fixed size</strong></em> mode lets you set a number of columns and rows.</td></tr><tr><td><strong>Bold Mode</strong></td><td>This option handles how the bold is displayed.</td></tr><tr><td><strong>Syntax highlighting mode</strong></td><td>This option can set one or more custom syntax highlights.</td></tr></tbody></table>

#### Advanced

![](https://cdnweb.devolutions.net/docs/RDMW0036_2024_2.png)

<table data-header-hidden><thead><tr><th width="235.5999755859375"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Answerback</strong></td><td>The prompted predefined response returned when the server sends "ENQ".</td></tr><tr><td><strong>Enable remote monitoring</strong></td><td>If enabled, a status bar with the CPU, RAM &#x26; Swap %'s appears at the bottom.</td></tr><tr><td><strong>Interval</strong></td><td>The interval at which a ping will be sent to update info on remote monitoring.</td></tr><tr><td><strong>Remote command</strong></td><td>Can be used to specify a command to start a shell (other than the default one).</td></tr><tr><td><strong>Bell behavior</strong></td><td>How Remote Desktop Manager will react to the SSH terminal sending the bell character.</td></tr><tr><td><strong>Enable compression</strong></td><td>Allows sending compressed data or not.</td></tr></tbody></table>

### SFTP

![](https://cdnweb.devolutions.net/docs/RDMW6031_2026_1.png)

<table data-header-hidden><thead><tr><th width="259.60003662109375"></th><th></th></tr></thead><tbody><tr><td><strong>Automatically open file transfer tab</strong></td><td>Automatically opens the file transfer tab when the terminal is open.</td></tr><tr><td><strong>Start minimized</strong></td><td>Minimizes the file transfer tab when the terminal session is open.</td></tr><tr><td><strong>Log to file</strong></td><td>Set a path and file to keep logs.</td></tr><tr><td><strong>Verbose</strong></td><td>How verbose logs are written.</td></tr><tr><td><strong>Show files in tree view</strong></td><td>Shows files in the file transfer tab.</td></tr><tr><td><strong>Show hidden files</strong></td><td>Shows hidden files in the file transfer tab.</td></tr><tr><td><strong>Home directory</strong></td><td>The directory at the root of the file transfer tab.</td></tr><tr><td><strong>Starting location</strong></td><td>Sets the selected folder when starting the file transfer tab.</td></tr><tr><td><strong>Zmodem download directory</strong></td><td>Where the Zmodem files will be downloaded.</td></tr><tr><td><strong>Show local files</strong></td><td>Show local files in the file transfer tab.</td></tr></tbody></table>

### Keyboard

#### General

![](https://cdnweb.devolutions.net/docs/RDMW0037_2024_2.png)

<table data-header-hidden><thead><tr><th width="206"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Cursor key mode</strong></td><td>Changes the cursor key mode between <em><strong>Normal</strong></em> and <em><strong>Application</strong></em>.</td></tr><tr><td><strong>Backspace key mode</strong></td><td>Changes the backspace key mode between <em><strong>Control-H</strong></em> and <em><strong>Control-? (ASCII code 127)</strong></em>.</td></tr><tr><td><strong>Home / End key mode</strong></td><td>Changes the home / end key mode between <em><strong>Standard</strong></em> and <em><strong>RXVT</strong></em>.</td></tr><tr><td><strong>Function keys mode</strong></td><td>Changes how the function keys are handled.</td></tr></tbody></table>

#### Key mapping

![](https://cdnweb.devolutions.net/docs/RDMW0038_2024_2.png)

<table data-header-hidden><thead><tr><th width="131.60003662109375"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Key</strong></td><td>Click the <em><strong>New</strong></em> button to map a sequence triggered by a key plus a modifier.</td></tr></tbody></table>

### X11 forwarding

![](https://cdnweb.devolutions.net/docs/RDMW0039_2024_2.png)

| **SETTINGS**              | **DESCRIPTION**                         |
| ------------------------- | --------------------------------------- |
| **Enable X11 forwarding** | Enables or disables the X11 forwarding. |

### Logs

![](https://cdnweb.devolutions.net/docs/RDMW0040_2024_2.png)

<table data-header-hidden><thead><tr><th width="188.4000244140625"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Enable logging</strong></td><td>The <strong>Global</strong> mode requires setting a default path and entering a filename.</td></tr><tr><td><strong>Log path</strong></td><td>Includes the path and the file for the log. The default log path can be configured in <strong>File</strong>– <strong>Settings</strong>– <strong>Entry types</strong>– <strong>Sessions</strong> – <strong>Terminal</strong>, under the <strong>Logging</strong> section.</td></tr><tr><td><strong>Log mode</strong></td><td>The <strong>Event</strong> mode only logs core events. The <strong>Printable output</strong> mode logs everything happening visibly in the terminal.</td></tr><tr><td><strong>Log filename</strong></td><td>The name of the file at the location defined in <strong>File</strong>– <strong>Settings</strong> – <strong>Session</strong> – <strong>Terminal</strong>– <strong>Default path</strong>.</td></tr><tr><td><strong>Log overwrite mode</strong></td><td><p>This option is only available with the <strong>Printable output</strong> <strong>Log mode</strong>:</p><ul><li><strong>Prompt</strong>: asks for <strong>Append</strong> or <strong>Overwrite</strong>.</li><li><strong>Append</strong>: Writes at the end of the file.</li><li><strong>Overwrite</strong>: Overwrites the file with logs specific to the current session.</li></ul></td></tr><tr><td><strong>Verbose</strong></td><td>This will set how in-depth logs are (only available for the <strong>Event</strong> mode).</td></tr><tr><td><strong>Log to terminal</strong></td><td>Toggle to display the logs in the terminal.</td></tr></tbody></table>

### Macro

![](https://cdnweb.devolutions.net/docs/RDMW0041_2024_2.png)

<table data-header-hidden><thead><tr><th width="213.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Enable macro</strong></td><td>The <em><strong>Yes</strong></em> option enables the macro bar, which appears at the top when the SSH terminal is launched.</td></tr><tr><td><strong>Hide premade macros</strong></td><td>Toggle this to hide premade macros.</td></tr><tr><td><strong>Macro list source</strong></td><td>The <em><strong>Entire vault</strong></em> option only lists macros from the current vault. The <em><strong>Custom</strong></em> option selects only specific macros.</td></tr></tbody></table>

### Advanced

![](https://cdnweb.devolutions.net/docs/RDMW0042_2024_2.png)

<table data-header-hidden><thead><tr><th width="292.4000244140625"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Internet protocol</strong></td><td>Choose between IPv4 or IPv6.</td></tr><tr><td><strong>Interactive authentication in terminal</strong></td><td>This option manages the behavior when the terminal asks you for interactive authentication. The <strong>No</strong> option makes Remote Desktop Manager manage it, while <strong>Yes</strong> makes the terminal manage it.</td></tr><tr><td><strong>Display error messages</strong></td><td>Choose to show error messages or not.</td></tr><tr><td><strong>Always accept fingerprint</strong></td><td>Always accept fingerprints or not.</td></tr><tr><td><strong>Mouse click mode</strong></td><td><p>Changes right-click behavior:</p><ul><li><strong>Windows</strong>: prompts a context menu.</li><li><strong>Compromise</strong>: pastes.</li><li><strong>XTerm</strong>: Selects text.</li></ul></td></tr><tr><td><strong>Algorithm support</strong></td><td>In the <strong>Custom</strong> mode, click the ellipsis button to select one or multiple <strong>Cipher</strong>, <strong>Host key</strong>, <strong>Kex</strong> and/or <strong>MAC</strong> algorithms.</td></tr><tr><td><strong>Minimum Diffie-Hellman key size</strong></td><td>Minimum key size in bits.</td></tr><tr><td><strong>Ignore Substitute character</strong></td><td>Ignores substitute characters or not.</td></tr><tr><td><strong>Enable TCP keepalives</strong></td><td>Enables TCP keepalives.</td></tr><tr><td><strong>Enable GSS API authentication</strong></td><td>Enables GSS API authentication.</td></tr><tr><td><strong>Skip environment variable setup</strong></td><td>Skips environment variable setup.</td></tr><tr><td><strong>Enable GSS API credential delegation</strong></td><td>Enable GSS API credential delegation.</td></tr><tr><td><strong>Allow SSH authentication agent forwarding</strong></td><td>Allow SSH authentication agent forwarding.</td></tr><tr><td><strong>Disable Nagle's algorithm</strong></td><td>Disable Nagle's algorithm.</td></tr><tr><td><strong>Use SSH authentication agent</strong></td><td>Uses the SSH authentication agent currently opened on your machine (including the Remote Desktop Manager SSH key agent).</td></tr><tr><td><strong>Ping interval</strong></td><td>A command is sent every X second to keep the connection alive.</td></tr><tr><td><strong>Ping string</strong></td><td>The string which is sent with the <strong>Ping interval</strong> option.</td></tr><tr><td><strong>Paste delay</strong></td><td>Added delay for pasting text.</td></tr><tr><td><strong>Environment variables</strong></td><td>Sets environment variables to be used by the terminal.</td></tr></tbody></table>

### See also

* [Devolutions Academy – Configure an SSH terminal entry in RDM](https://academy.devolutions.net/student/page/2625501-configure-an-ssh-terminal-entry-in-rdm?sid=dc781bc2-4637-4aba-a87b-f3332619aa7d\&sid_i=0)
* [Devolutions Academy – Use advanced configuration for SSH Terminal](https://academy.devolutions.net/student/path/2628397/activity/4280878)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/ssh-terminal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.