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

# FTP

Configure FTP session settings in Remote Desktop Manager, including host, credentials, security type, proxy, FTP over SSH, and logging options.

This article details the many settings and options available for ***FTP*** session entries in Remote Desktop Manager.

<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>Select how the session is displayed when the entry is launched.</td></tr><tr><td><strong>Host</strong></td><td>Where the host of the entry comes from. Select a host mode from the list. When the host comes from a linked host entry, the <em><strong>Host</strong></em> field of the <em><strong>General</strong></em> tab is unavailable.</td></tr><tr><td><strong>Credentials</strong></td><td>How the credentials of the session are provided. Select a credential mode from the list. When the credentials come from another source, the <em><strong>Username</strong></em>, <em><strong>Password</strong></em>, and <em><strong>Always ask for password</strong></em> settings of the <em><strong>General</strong></em> tab are unavailable.</td></tr></tbody></table>

### General

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td>The host name or IP address of the FTP server. Enter a host or click the button next to the field to choose one. Required unless the host comes from a linked host entry.</td></tr><tr><td><strong>Port</strong></td><td>The port used to connect to the server. The default port is 21.</td></tr><tr><td><strong>Username</strong></td><td>The username used to sign in to the server. Required unless the credentials come from another source.</td></tr><tr><td><strong>Password</strong></td><td>The password used to sign in to the server. Unavailable when <em><strong>Always ask for password</strong></em> is enabled, and disabled when the <em><strong>Disable password saving in vaults</strong></em> system setting is enabled.</td></tr><tr><td><strong>Always ask for password</strong></td><td>Prompt for the password every time the entry is launched.</td></tr><tr><td><strong>OTP prompt string</strong></td><td>The prompt string used to detect when to send the one-time password. Optional.</td></tr><tr><td><strong>Home directory</strong></td><td>The home directory on the server.</td></tr><tr><td><strong>Starting location</strong></td><td>The remote location where the session starts.</td></tr><tr><td><strong>Show files in tree view</strong></td><td>Show the files, in addition to the folders, in the tree view of the remote directory.</td></tr><tr><td><strong>Show hidden files</strong></td><td>Show the hidden files of the remote directory.</td></tr><tr><td><strong>Passive mode</strong></td><td>Use passive mode for the FTP connection.</td></tr></tbody></table>

### Security

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Security type</strong></td><td><p>Select the security used for the FTP connection:</p><ul><li><strong>No security</strong></li><li><strong>Explicit TLS or SSL</strong></li><li><strong>Implicit TLS or SSL</strong></li></ul></td></tr><tr><td><strong>Clear command channel</strong></td><td>Send the FTP commands over an unencrypted command channel. Unavailable when <em><strong>Security type</strong></em> is set to <em><strong>No security</strong></em>.</td></tr><tr><td><strong>Secure transfers</strong></td><td>Encrypt the file transfers. Unavailable when <em><strong>Security type</strong></em> is set to <em><strong>No security</strong></em>.</td></tr></tbody></table>

### Proxy

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Use proxy</strong></td><td>Connect to the server through a proxy. When enabled, the other proxy settings are displayed.</td></tr><tr><td><strong>Proxy URL</strong></td><td>The address of the proxy server.</td></tr><tr><td><strong>Port</strong></td><td>The port of the proxy server.</td></tr><tr><td><strong>Bypass proxy on local</strong></td><td>Do not use the proxy for local addresses.</td></tr><tr><td><strong>Proxy type</strong></td><td><p>Select the type of proxy:</p><ul><li><strong>Socks4</strong></li><li><strong>Socks4a</strong></li><li><strong>Socks5</strong></li><li><strong>HttpConnect</strong></li></ul></td></tr><tr><td><strong>Username</strong></td><td>The username used to sign in to the proxy. Leave empty when the proxy does not require it.</td></tr><tr><td><strong>Domain</strong></td><td>The domain of the proxy user account. Leave empty when the proxy does not require it.</td></tr><tr><td><strong>Password</strong></td><td>The password used to sign in to the proxy. Leave empty when the proxy does not require it.</td></tr></tbody></table>

### SSH settings

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Use FTP over SSH</strong></td><td>Connect to the FTP server through an SSH connection. When disabled, the other settings of this tab are unavailable.</td></tr><tr><td><strong>Host</strong></td><td>The host name or IP address of the SSH server.</td></tr><tr><td><strong>Port</strong></td><td>The port of the SSH server. The default port is 22.</td></tr></tbody></table>

**Credential**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Username</strong></td><td>The username used to sign in to the SSH server.</td></tr><tr><td><strong>Password</strong></td><td>The password used to sign in to the SSH server. Unavailable when <em><strong>Always ask for password</strong></em> is enabled.</td></tr><tr><td><strong>Always ask for password</strong></td><td>Prompt for the SSH password every time the entry is launched.</td></tr></tbody></table>

**Private key**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Private key</strong></td><td>Select where the private key used for the SSH connection comes from. The options offered depend on the data source and its settings.</td></tr><tr><td><strong>Vault</strong></td><td>The vault that holds the private key entry. Displayed when the private key comes from another entry and a vault can be selected.</td></tr><tr><td><strong>Entry</strong></td><td>The entry that holds the private key. Displayed when the private key comes from another entry.</td></tr><tr><td><strong>Search string</strong></td><td>The name of the private key entry to search for. Displayed when the private key is found by name.</td></tr><tr><td><strong>File</strong></td><td>The path of the local private key file. Displayed when <em><strong>Private key</strong></em> is set to <em><strong>File (local)</strong></em>.</td></tr><tr><td><strong>Passphrase</strong></td><td>The passphrase of the private key. Displayed when <em><strong>Private key</strong></em> is set to <em><strong>File (local)</strong></em> or <em><strong>Embedded data</strong></em>. Unavailable when <em><strong>Always prompt for passphrase</strong></em> is enabled.</td></tr><tr><td><strong>Always prompt for passphrase</strong></td><td>Prompt for the passphrase every time the entry is launched. Displayed 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>The private key stored in the entry. Use the buttons next to the field to generate, view, paste, browse for, or clear the key. Displayed when <em><strong>Private key</strong></em> is set to <em><strong>Embedded data</strong></em>.</td></tr></tbody></table>

**Advanced**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Algorithm support</strong></td><td><p>Select which SSH algorithms are supported:</p><ul><li><strong>Default</strong></li><li><strong>Custom</strong> — Click the button next to the list to select the algorithms.</li></ul></td></tr><tr><td><strong>Use SSH authentication agent</strong></td><td>Authenticate through the SSH authentication agent. When enabled, the private key of the entry is ignored to avoid conflicts with the agent.</td></tr></tbody></table>

### Advanced

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Show local files</strong></td><td>Show the local files next to the remote files in the session.</td></tr><tr><td><strong>Local path</strong></td><td>The local folder displayed when the session starts. Click the browse button to select a folder. Available only when <em><strong>Show local files</strong></em> is enabled.</td></tr><tr><td><strong>Show logs</strong></td><td>Show the logs of the session. When enabled, the <em><strong>Verbose</strong></em> and <em><strong>Log to file</strong></em> settings are displayed.</td></tr><tr><td><strong>Verbose</strong></td><td>The level of detail of the logs, from 0 to 4.</td></tr><tr><td><strong>Log to file</strong></td><td>Save the logs to a file. When enabled, the <em><strong>Log path</strong></em> setting is displayed.</td></tr><tr><td><strong>Log path</strong></td><td>The path of the log file. Click the browse button to select or create a file.</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/ftp.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.
