> 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 shell

Configure the SSH shell entry in Remote Desktop Manager, covering host, credentials, SSH key, proxy, terminal, SFTP, logs, and advanced settings.

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.

In several lists, the ***Default*** item uses the value set in the application settings and shows that value in parentheses, for example ***Default (Yes)***.
{% 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><p>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.</p><p>On Linux, the list also offers <em><strong>Default (inherited)</strong></em>, which uses the display mode of the nearest parent folder that sets one, otherwise the default of the entry type. The mode it resolves to is shown next to the list.</p></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 of the vault. <em><strong>Inherited</strong></em> is used when the host is inherited from a higher-level or parent entry. <em><strong>Linked (user vault)</strong></em> links the host to a host entry of the user vault and is offered only in the user vault.</td></tr><tr><td><strong>Credentials</strong></td><td><ul><li><strong>Username and password</strong>: You will set the username and password in the <em><strong>General</strong></em> tab.</li><li><strong>Linked (vault)</strong>: Links to a credential entry of the same vault. To use this feature, users must have the <em><strong>View</strong></em> permission on the entry.</li><li><strong>Linked (cross vault)</strong>: Links to a credential entry selected from another vault.</li><li><strong>Linked (user vault)</strong>: Links to a credential entry of the user vault. Offered only in the user vault.</li><li><strong>Find by name (user vault)</strong>: Finds the credential entry in the user vault by name. Not offered in the user vault.</li><li><strong>Inherited</strong>: Inheritance means that credentials will automatically be passed down from a higher-level entry to lower-level entries that inherit from it.</li><li><strong>My personal credentials</strong>: 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><strong>None</strong>: Remote Desktop Manager will not send credentials to the entry.</li><li><strong>My privileged account</strong>: 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><li><strong>Use linked host credentials</strong>: Uses the credentials of the linked host entry. Available when <em><strong>Host</strong></em> is set to <em><strong>Linked (vault)</strong></em> or <em><strong>Linked (user vault)</strong></em>.</li></ul></td></tr></tbody></table>

### General

<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. Available when <em><strong>Host</strong></em> is set to <em><strong>Host configured</strong></em>.</td></tr><tr><td><strong>Port</strong></td><td>Select the default port (22) or use the <em><strong>Port generator</strong></em> to generate one.</td></tr><tr><td><strong>Set host public key</strong></td><td>Set the public key expected from the SSH host. Once a key is set, a clear button removes it, and the <em><strong>View comment</strong></em> button displays the comment stored with the key, if any.</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. Unavailable when <em><strong>Always ask for password</strong></em> or <em><strong>Send an empty password</strong></em> is checked.</td></tr><tr><td><strong>Always ask for password</strong></td><td>Prompt for the password instead of saving it in the entry. Unavailable when <em><strong>Send an empty password</strong></em> is checked.</td></tr><tr><td><strong>Send an empty password</strong></td><td>Send an empty password to the host. Unavailable when <em><strong>Always ask for password</strong></em> is checked.</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 smart card</strong></td><td>Uses the smart card.</td></tr><tr><td><strong>Certificate method</strong></td><td><p>The method used to fetch the smart card credentials. Available when <em><strong>Use smart card</strong></em> is checked:</p><ul><li><strong>CAPI</strong></li><li><strong>PKCS</strong></li><li><strong>Try all modes</strong></li></ul></td></tr><tr><td><strong>PIN code</strong></td><td>The smart card PIN. Available when <em><strong>Use smart card</strong></em> is checked.</td></tr></tbody></table>

### SSH key

<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 colspan="2"><strong>Key</strong></td></tr><tr><td><strong>Private key</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 private key file.</li><li><strong>Embedded data</strong>, which lets you manually enter a private key (or generate one via the <em><strong>Generate key</strong></em> button).</li><li><strong>Linked (vault)</strong>, which lets you choose an SSH key entry of the vault from which to retrieve a key. To use this feature, users must have the <em><strong>View</strong></em> permission on the entry.</li><li><strong>Linked (cross vault)</strong>, which lets you choose an SSH key entry from another vault.</li><li><strong>My personal SSH key</strong>, which uses the SSH key set in <em><strong>File</strong></em> – <em><strong>My account settings</strong></em> – <em><strong>My personal SSH key</strong></em>, under <em><strong>Local credentials</strong></em>. Click the edit button next to the list to change it.</li><li><strong>Privileged account</strong>, which lets you choose a PAM account. This option requires a PAM license, and it is listed on its own only when the data source cannot offer privileged accounts through the linked options.</li></ul></td></tr><tr><td><strong>Vault</strong></td><td>The vault that contains the SSH key entry. Available when <em><strong>Private key</strong></em> is set to <em><strong>Linked (cross vault)</strong></em>.</td></tr><tr><td><strong>Entry</strong></td><td>The SSH key entry to use. Click the add button to create a new SSH key entry, or the clear button to remove the selection. Available when <em><strong>Private key</strong></em> is set to <em><strong>Linked (vault)</strong></em>, <em><strong>Linked (cross vault)</strong></em>, or <em><strong>Privileged account</strong></em>.</td></tr><tr><td><strong>File</strong></td><td>This field points to the SSH key file (this field is only available if the <em><strong>Private key</strong></em> is <em><strong>File (local)</strong></em>).</td></tr><tr><td><strong>Passphrase</strong></td><td>The passphrase used to decrypt the key. Available when <em><strong>Private key</strong></em> is set to <em><strong>File (local)</strong></em> or <em><strong>Embedded data</strong></em>, and unavailable when <em><strong>Always prompt for passphrase</strong></em> is checked.</td></tr><tr><td><strong>Always prompt for passphrase</strong></td><td>Prompt for the passphrase each time the key is used instead of saving it. Available when <em><strong>Private key</strong></em> is set to <em><strong>File (local)</strong></em> or <em><strong>Embedded data</strong></em>.</td></tr><tr><td><strong>Private key data</strong></td><td>Select or generate a private key file (this field is only for <em><strong>Embedded data</strong></em> and the key is saved in Remote Desktop Manager). The buttons next to the field generate, view, paste, browse for, or clear the key.</td></tr><tr><td colspan="2"><strong>Certificate</strong></td></tr><tr><td><strong>Certificate type</strong></td><td><p>The source of the certificate. The <em><strong>Certificate</strong></em> sub-tab is available when <em><strong>Private key</strong></em> is set to <em><strong>File (local)</strong></em> or <em><strong>Embedded data</strong></em>, or when a certificate is already configured. Choose between:</p><ul><li><strong>No certificate</strong></li><li><strong>File (local)</strong>, which lets you select a local certificate file.</li><li><strong>Embedded data</strong>, which stores the certificate in the SSH entry.</li></ul><p>For a linked key, an information icon indicates that a certificate configured on the linked SSH credential takes priority over the one specified here.</p></td></tr><tr><td><strong>File</strong></td><td>The path to the certificate file. Available when <em><strong>Certificate type</strong></em> is set to <em><strong>File (local)</strong></em>.</td></tr><tr><td><strong>Certificate</strong></td><td>The certificate stored in the entry. The buttons next to the field view, clear, paste, or browse for the certificate. Available when <em><strong>Certificate type</strong></em> is set to <em><strong>Embedded data</strong></em>.</td></tr></tbody></table>

### Proxy

<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><p>Choose between:</p><ul><li><strong>None</strong></li><li><strong>Link</strong>, which points to a <em><strong>Proxy Tunnel</strong></em> entry.</li><li><strong>Custom</strong>, which sets up a custom proxy with the same settings as a proxy tunnel.</li></ul></td></tr><tr><td><strong>Proxy</strong></td><td>The proxy entry to use. Available when <em><strong>Proxy mode</strong></em> is set to <em><strong>Link</strong></em>.</td></tr><tr><td><strong>Proxy type</strong></td><td><p>The type of custom proxy. Available when <em><strong>Proxy mode</strong></em> is set to <em><strong>Custom</strong></em>:</p><ul><li><strong>Socks4</strong></li><li><strong>Socks5</strong></li><li><strong>HTTP</strong></li><li><strong>Local</strong></li></ul><p><em><strong>Telnet</strong></em> is listed only for an entry that already uses it.</p></td></tr><tr><td><strong>Host</strong></td><td>The host name and port of the proxy. Available when <em><strong>Proxy type</strong></em> is not <em><strong>Local</strong></em>.</td></tr><tr><td><strong>Credential mode</strong></td><td><p>The source of the proxy credentials:</p><ul><li><strong>Username and password</strong>, which shows the <em><strong>Username</strong></em>, <em><strong>Password</strong></em>, and <em><strong>Always ask for password</strong></em> fields.</li><li><strong>Linked (vault)</strong>, which shows the <em><strong>Credential</strong></em> field to select a credential entry of the vault.</li><li><strong>My personal credentials</strong></li><li><strong>Linked (user vault)</strong>, which shows the <em><strong>Credential</strong></em> field to select a credential entry of the user vault. Offered only in the user vault.</li><li><strong>Find by name (user vault)</strong>, which shows a field to enter the name of the credential entry to find in the user vault. Not offered in the user vault.</li><li><strong>My privileged account</strong></li></ul><p>For <em><strong>My personal credentials</strong></em> and <em><strong>My privileged account</strong></em>, a button next to the list opens <em><strong>My account settings</strong></em>.</p></td></tr><tr><td><strong>Excluded hosts</strong></td><td><p>Hosts that do not go through the proxy. Available when <em><strong>Proxy type</strong></em> is not <em><strong>Local</strong></em>. The list supports:</p><ul><li>Wildcards, such as asterisks, which are interpreted as any number of characters (including 0), and question marks, each of which represents a single character.</li><li>Leading point notation, according to which ".domain.com" equals "*.domain.com".</li></ul></td></tr><tr><td><strong>Consider proxying localhost connections</strong></td><td>Send connections to the local host through the proxy as well. Available when <em><strong>Proxy type</strong></em> is not <em><strong>Local</strong></em>.</td></tr><tr><td><strong>DNS name lookup at the proxy end</strong></td><td><p>Where host names are resolved. Available when <em><strong>Proxy type</strong></em> is not <em><strong>Local</strong></em>:</p><ul><li><strong>Automatic</strong></li><li><strong>Yes</strong></li><li><strong>No</strong></li></ul></td></tr><tr><td><strong>Telnet / local proxy command</strong></td><td>The command used by the <em><strong>Local</strong></em> or <em><strong>Telnet</strong></em> proxy type. Leave the field blank to use the default.</td></tr></tbody></table>

### SSH gateway

<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><p>Choose between:</p><ul><li><strong>None</strong></li><li><strong>Custom</strong>, which lets you configure an SSH gateway. Gateways are listed with their host and port, and the toolbar adds, edits, deletes, and reorders them.</li><li><strong>Linked</strong>, which picks from an already existing SSH gateway in the <em><strong>Gateway</strong></em> field.</li></ul></td></tr></tbody></table>

### Post-login

<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, from 500 to 50000 milliseconds.</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 <em><strong>New</strong></em> or <em><strong>Edit</strong></em> button will bring up the <em><strong>Macro edit</strong></em> window with:</p><ul><li>The <em><strong>Command</strong></em> field (supports variables)</li><li>The <em><strong>Expected prompt</strong></em> (when RDM sees this value it will send this command)</li><li>The <em><strong>Timeout</strong></em> for the <em><strong>Expected prompt</strong></em> option</li></ul><p>The toolbar also deletes commands and moves them up or down.</p></td></tr></tbody></table>

### Before closing

<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, from 500 to 50000 milliseconds.</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>Command 1 to Command 5</strong></td><td>Five command lines, run in order.</td></tr><tr><td><strong>More commands</strong></td><td>Additional commands, one per line.</td></tr></tbody></table>

### Terminal

<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 colspan="2"><strong>Configuration</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. Check the box to enter the terminal type in the field next to it.</td></tr><tr><td><strong>Encoding</strong></td><td>Changes character encoding. Choose <em><strong>Default</strong></em>, or a specific character set: UTF-8, the ISO-8859 Latin character sets, the Windows code pages Win1250 to Win1258, CP437, CP850, CP932 (Shift_JIS), CP936 (GBK), or EUC-JP.</td></tr><tr><td><strong>Auto wrap</strong></td><td><p>Enable or disable auto wrap:</p><ul><li><strong>Default</strong></li><li><strong>On</strong></li><li><strong>Off</strong></li></ul></td></tr><tr><td><strong>Local echo</strong></td><td><p>Enable or disable local echo. The <em><strong>auto</strong></em> option lets the server decide:</p><ul><li><strong>Default</strong></li><li><strong>auto</strong></li><li><strong>On</strong></li><li><strong>Off</strong></li></ul></td></tr><tr><td><strong>Initial keypad mode</strong></td><td><p>How the terminal behaves with the keypad:</p><ul><li><strong>Default</strong></li><li><strong>Application</strong></li><li><strong>Normal</strong></li></ul></td></tr><tr><td><strong>Disable application keypad mode</strong></td><td>Disables the app keypad. Choose between <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, and <em><strong>No</strong></em>.</td></tr><tr><td><strong>Cursor type</strong></td><td><p>Changes the UI cursor type:</p><ul><li><strong>Default</strong></li><li><strong>Block</strong></li><li><strong>Underline</strong></li><li><strong>Vertical line</strong></li></ul></td></tr><tr><td><strong>Cursor blink</strong></td><td>Turns the cursor blink on or off. Choose between <em><strong>Default</strong></em>, <em><strong>On</strong></em>, and <em><strong>Off</strong></em>.</td></tr><tr><td><strong>Cursor blink rate</strong></td><td>Delay between every cursor blink, from 0 to 10000 milliseconds.</td></tr><tr><td><strong>Reset scroll on display</strong></td><td>Enable or disable scroll reset. Choose between <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, and <em><strong>No</strong></em>.</td></tr><tr><td><strong>Reset scroll on keypress</strong></td><td>Enable or disable scroll reset. Choose between <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, and <em><strong>No</strong></em>.</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 line feed</strong></td><td>Adds a carriage return with every linefeed.</td></tr><tr><td><strong>Implicit line feed 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. Choose <em><strong>Default</strong></em>, or <em><strong>Override</strong></em> to enter a number of lines (from 0 to 2,000,000,000).</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><tr><td colspan="2"><strong>Display</strong></td></tr><tr><td><strong>Font</strong></td><td>Allows font overriding. Choose <em><strong>Default</strong></em>, or <em><strong>Override</strong></em> to select a font and its <em><strong>Size</strong></em> (from 1 to 200).</td></tr><tr><td><strong>Bold mode</strong></td><td><p>This option handles how the bold is displayed:</p><ul><li><strong>Default</strong></li><li><strong>Change font</strong></li><li><strong>Change color</strong></li><li><strong>Change font and color</strong></li></ul></td></tr><tr><td><strong>Font quality</strong></td><td><p>The rendering quality of the font. Available when <em><strong>Font</strong></em> is set to <em><strong>Override</strong></em>:</p><ul><li><strong>Default</strong></li><li><strong>Anti-aliased</strong></li><li><strong>Non-anti-aliased</strong></li><li><strong>ClearType</strong></li></ul></td></tr><tr><td><strong>Colors</strong></td><td>Allows color overriding. Choose <em><strong>Default</strong></em>, or <em><strong>Override</strong></em> to use the <em><strong>Customize colors</strong></em> button and the button that imports color schemes.</td></tr><tr><td><strong>Terminal size</strong></td><td>Choose <em><strong>Default</strong></em>, or <em><strong>Fixed size</strong></em> to set a number of <em><strong>Columns</strong></em> (from 20 to 1000) and <em><strong>Rows</strong></em> (from 5 to 1000), and a <em><strong>Mode</strong></em> (<em><strong>Standard</strong></em> or <em><strong>Fit</strong></em>).</td></tr><tr><td><strong>Syntax highlighting mode</strong></td><td><p>This option can set one or more custom syntax highlights:</p><ul><li><strong>Default profile (local configuration)</strong></li><li><strong>Default profile (system settings)</strong></li><li><strong>Linked (system settings)</strong>, which shows the <em><strong>Profile</strong></em> list to select a profile.</li><li><strong>Custom</strong>, which shows the <em><strong>Customize</strong></em> button.</li></ul><p>The system settings options are available only when the data source supports system settings.</p></td></tr><tr><td><strong>Allow remote-controlled window title changes</strong></td><td>Changes the entry tab name depending on what the server feeds.</td></tr><tr><td><strong>Accept resize requests from the server</strong></td><td>Let the server resize the terminal window. Available when the entry's <em><strong>Display</strong></em> is set to <em><strong>Undocked</strong></em>.</td></tr><tr><td colspan="2"><strong>Advanced</strong></td></tr><tr><td><strong>Bracketed paste</strong></td><td>Choose between <em><strong>Default</strong></em> and <em><strong>Disable bracketed paste</strong></em>.</td></tr><tr><td><strong>Enable compression</strong></td><td>Allows sending compressed data or not. Choose between <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, and <em><strong>No</strong></em>.</td></tr><tr><td><strong>Bell behavior</strong></td><td><p>How Remote Desktop Manager will react to the SSH terminal sending the bell character:</p><ul><li><strong>Default</strong></li><li><strong>None</strong></li><li><strong>Sound</strong></li><li><strong>Visual (flash window)</strong></li><li><strong>Change tab color</strong></li></ul></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. Choose between <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, and <em><strong>No</strong></em>.</td></tr><tr><td><strong>Interval</strong></td><td>The interval at which a ping will be sent to update info on remote monitoring, from 1 to 3600 seconds. Hidden when <em><strong>Enable remote monitoring</strong></em> is set to <em><strong>No</strong></em>.</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>Answerback</strong></td><td>The prompted predefined response returned when the server sends "ENQ".</td></tr></tbody></table>

### SFTP

<table data-header-hidden><thead><tr><th width="259.60003662109375"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Automatically open the 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>Keep logs of the file transfers in a file.</td></tr><tr><td><strong>Log path</strong></td><td>The path and file of the log. Available when <em><strong>Log to file</strong></em> is checked.</td></tr><tr><td><strong>Verbose</strong></td><td>How verbose logs are written, from 0 to 4.</td></tr><tr><td colspan="2"><strong>Remote</strong></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 colspan="2"><strong>Local</strong></td></tr><tr><td><strong>Show local files</strong></td><td>Show local files in the file transfer tab.</td></tr><tr><td><strong>Starting location</strong></td><td>The local folder selected when starting the file transfer tab.</td></tr><tr><td colspan="2"><strong>Transfer</strong></td></tr><tr><td><strong>Transfer type</strong></td><td><p>How files are transferred:</p><ul><li><strong>Binary</strong></li><li><strong>Text</strong></li><li><strong>Automatic</strong></li></ul></td></tr><tr><td><strong>Text file extensions</strong></td><td>The extensions of the files transferred as text. Available when <em><strong>Transfer type</strong></em> is set to <em><strong>Automatic</strong></em>.</td></tr><tr><td><strong>Local line ending</strong></td><td>The line ending of text files on the local computer: <em><strong>Default</strong></em>, <em><strong>LF</strong></em>, or <em><strong>CRLF</strong></em>. Unavailable when <em><strong>Transfer type</strong></em> is set to <em><strong>Binary</strong></em>.</td></tr><tr><td><strong>Remote line ending</strong></td><td>The line ending of text files on the remote host: <em><strong>Default</strong></em>, <em><strong>LF</strong></em>, or <em><strong>CRLF</strong></em>. Unavailable when <em><strong>Transfer type</strong></em> is set to <em><strong>Binary</strong></em>.</td></tr></tbody></table>

### Keyboard

<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 colspan="2"><strong>Configuration</strong></td></tr><tr><td><strong>Cursor key mode</strong></td><td>Changes the cursor key mode between <em><strong>Default</strong></em>, <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>Default</strong></em>, <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>Default</strong></em>, <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. Choose <em><strong>Default</strong></em>, <em><strong>ESC[N~</strong></em>, <em><strong>Linux</strong></em>, <em><strong>Xterm R6</strong></em>, <em><strong>VT400</strong></em>, <em><strong>VT100+</strong></em>, <em><strong>SCO</strong></em>, <em><strong>Common</strong></em>, <em><strong>Common (alternative)</strong></em>, <em><strong>HP-UX</strong></em>, <em><strong>Linux 220</strong></em>, <em><strong>Linux (alternative)</strong></em>, <em><strong>Pick</strong></em>, <em><strong>VT52</strong></em>, <em><strong>Wyse</strong></em>, or <em><strong>XTerm</strong></em>.</td></tr><tr><td colspan="2"><strong>Key mapping</strong></td></tr><tr><td><strong>Key mapping list</strong></td><td>Click the add button to map a sequence triggered by a key plus a modifier. The list shows the <em><strong>Key</strong></em>, <em><strong>Modifier</strong></em>, and <em><strong>Sequence</strong></em> of each mapping, and the toolbar also edits, deletes, and reorders them.</td></tr></tbody></table>

### X11 forwarding

<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><strong>Enable X11 forwarding</strong></td><td>Enables or disables the X11 forwarding. Choose between <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, and <em><strong>No</strong></em>. The options below are available when it is set to <em><strong>Yes</strong></em>.</td></tr><tr><td><strong>XServer type</strong></td><td>The X server used to display the remote graphical applications. <em><strong>Devolutions</strong></em> uses the X server included with Remote Desktop Manager, which starts automatically when the session opens and closes when the last session using it is closed. A button next to the list opens the Devolutions XServer setup, also available in <em><strong>Tools</strong></em> – <em><strong>All tools</strong></em> – <em><strong>XServer</strong></em>. A banner states that the Devolutions XServer is available on Windows only. <em><strong>Custom</strong></em> uses a third party X server, such as Xming, that you install and start yourself. The options below are available only with <em><strong>Custom</strong></em>.</td></tr><tr><td><strong>X display location</strong></td><td>The display used by the custom X server, for example <code>localhost:0</code>.</td></tr><tr><td><strong>Protocol</strong></td><td>The authentication protocol used with the custom X server, either <em><strong>MIT-Magic-Cookie-1</strong></em> or <em><strong>XDM-Authorization-1</strong></em>.</td></tr><tr><td><strong>X authority file for local display</strong></td><td>The path to the <code>.Xauthority</code> file holding the authentication token for the local display. Select the ellipsis button to browse for the file.</td></tr></tbody></table>

### Logs

<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>Write the session's log to a file. Unavailable when <em><strong>Log into terminal</strong></em> is checked.</td></tr><tr><td><strong>Log path type</strong></td><td>The <em><strong>Custom</strong></em> mode requires the path and file name. The <em><strong>Global</strong></em> 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. Available when <em><strong>Log path type</strong></em> is set to <em><strong>Custom</strong></em>.</td></tr><tr><td><strong>Log filename</strong></td><td>The name of the file at the location defined in <em><strong>File</strong></em> – <em><strong>Settings</strong></em> – <em><strong>Session</strong></em> – <em><strong>Terminal</strong></em> – <em><strong>Default path</strong></em>. Available when <em><strong>Log path type</strong></em> is set to <em><strong>Global</strong></em>.</td></tr><tr><td><strong>Log mode</strong></td><td>The <em><strong>Event</strong></em> mode only logs core events. The <em><strong>Printable output</strong></em> mode logs everything happening visibly in the terminal.</td></tr><tr><td><strong>Log overwrite mode</strong></td><td><p>This option is only available with the <em><strong>Printable output</strong></em> <em><strong>Log mode</strong></em>:</p><ul><li><strong>Default</strong></li><li><strong>Prompt</strong>: asks for <em><strong>Append</strong></em> or <em><strong>Overwrite</strong></em>.</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, from 0 to 4.</td></tr><tr><td><strong>Log into terminal</strong></td><td>Toggle to display the logs in the terminal.</td></tr></tbody></table>

### Macros

<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. Choose between <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, and <em><strong>No</strong></em>.</td></tr><tr><td><strong>Hide pre-made macros</strong></td><td>Toggle this to hide premade macros. Hidden when <em><strong>Enable macro</strong></em> is set to <em><strong>No</strong></em>.</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 selection</strong></em> option selects only specific macros, which are listed with their name and folder and added, removed, or reordered with the toolbar. Hidden when <em><strong>Enable macro</strong></em> is set to <em><strong>No</strong></em>.</td></tr></tbody></table>

### Advanced

<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 <em><strong>Default</strong></em>, <em><strong>IPv4</strong></em>, or <em><strong>IPv6</strong></em>.</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 <em><strong>No</strong></em> option makes Remote Desktop Manager manage it, while <em><strong>Yes</strong></em> makes the terminal manage it. <em><strong>Default</strong></em> is also available.</td></tr><tr><td><strong>Display error messages</strong></td><td>Choose to show error messages or not: <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, or <em><strong>No</strong></em>.</td></tr><tr><td><strong>Always accept fingerprint</strong></td><td>Always accept fingerprints or not: <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, or <em><strong>No</strong></em>.</td></tr><tr><td><strong>Mouse click mode</strong></td><td><p>Changes right-click behavior:</p><ul><li><strong>Default</strong></li><li><strong>Windows</strong>: prompts a context menu.</li><li><strong>Compromise</strong>: pastes.</li><li><strong>XTerm</strong>: Selects text.</li></ul><p>Not shown on Linux.</p></td></tr><tr><td><strong>Algorithm support</strong></td><td>In the <em><strong>Custom</strong></em> mode, click the button next to the list to select one or multiple <em><strong>Cipher</strong></em>, <em><strong>Host key</strong></em>, <em><strong>Kex</strong></em> and/or <em><strong>MAC</strong></em> algorithms. The other mode is <em><strong>Default</strong></em>.</td></tr><tr><td><strong>Minimum Diffie-Hellman key size</strong></td><td>Minimum key size in bits. Choose <em><strong>Default</strong></em>, or <em><strong>Custom</strong></em> to enter a size from 0 to 999999 bits.</td></tr><tr><td><strong>Ignore substitute character</strong></td><td>Ignores substitute characters or not: <em><strong>Default</strong></em>, <em><strong>Yes</strong></em>, or <em><strong>No</strong></em>.</td></tr><tr><td><strong>Enable TCP keep-alives</strong></td><td>Enables TCP keepalives.</td></tr><tr><td><strong>Disable Nagle's algorithm</strong></td><td>Disable Nagle's algorithm.</td></tr><tr><td><strong>Enable GSSAPI authentication</strong></td><td>Enables GSS API authentication.</td></tr><tr><td><strong>Enable GSSAPI credential delegation</strong></td><td>Enable GSS API credential delegation.</td></tr><tr><td><strong>Skip environment variable setup</strong></td><td>Skips environment variable setup.</td></tr><tr><td><strong>Allow SSH authentication agent forwarding</strong></td><td>Allow SSH authentication agent forwarding.</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). When this option or agent forwarding is checked, the entry's private key is ignored to avoid conflicts with the agent.</td></tr><tr><td><strong>Ping interval</strong></td><td>A command is sent every X second to keep the connection alive, from 0 to 86400 seconds.</td></tr><tr><td><strong>Ping string</strong></td><td>The string which is sent with the <em><strong>Ping interval</strong></em> option. Available when <em><strong>Ping interval</strong></em> is greater than 0.</td></tr><tr><td><strong>Paste delay</strong></td><td>Added delay for pasting text, from 0 to 5000 milliseconds.</td></tr><tr><td><strong>Separate paste in line groups</strong></td><td>Paste text in groups of lines. Enter the number of lines per group (from 0 to 50) in the field next to the checkbox.</td></tr><tr><td><strong>Environment variables</strong></td><td>Sets environment variables to be used by the terminal.</td></tr><tr><td><strong>Disconnect action</strong></td><td><p>What happens to the tab when the session disconnects. Shown on Linux only:</p><ul><li><strong>Default (inherited)</strong></li><li><strong>Close tab</strong></li><li><strong>Keep tab open</strong></li><li><strong>Reconnect</strong></li></ul></td></tr><tr><td><strong>Send keep-alive pings</strong></td><td>Send keep-alive pings to keep the connection open. Shown on Linux only.</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 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/ssh-terminal.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.
