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

# FileZilla/WinSCP (FTP)

Configure FileZilla/WinSCP (FTP) session settings in Remote Desktop Manager, including host, credentials, application, protocol, encryption, and SSH key.

This article details the many settings and options available for ***FileZilla/WinSCP (FTP)*** session entries in Remote Desktop Manager.

{% hint style="info" %}
When the entry is displayed embedded, the ***Windows Explorer*** and ***Default configuration*** applications are unavailable. The ***SSH key*** tab is available only when ***Application*** is set to ***WinSCP***.
{% 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 session is displayed when the entry is launched:</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>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. 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>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, except when <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>, where the field is unavailable.</td></tr><tr><td><strong>Port</strong></td><td>The port used to connect to the server. The default port is 21. Unavailable when <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>.</td></tr><tr><td><strong>Anonymous</strong></td><td>Connect to the server anonymously. When enabled, the <em><strong>Username</strong></em> and <em><strong>Password</strong></em> fields are unavailable. Unavailable when <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>.</td></tr><tr><td><strong>Username</strong></td><td>The username used to sign in to the server. Unavailable when <em><strong>Anonymous</strong></em> is enabled or <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>.</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> or <em><strong>Anonymous</strong></em> is enabled, or when <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>. Also unavailable 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>Home directory</strong></td><td>The remote directory to open on the server. Unavailable when <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>.</td></tr><tr><td><strong>Application</strong></td><td><p>Select the application used to open the session:</p><ul><li><strong>Windows Explorer</strong> — Unavailable when the entry is displayed embedded. Not supported on macOS.</li><li><strong>FileZilla</strong></li><li><strong>WinSCP</strong> — Not supported on macOS and Linux.</li><li><strong>Default configuration</strong> — Unavailable when the entry is displayed embedded.</li></ul></td></tr><tr><td><strong>Starting location</strong></td><td>The remote location where the session starts. Unavailable when <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>.</td></tr><tr><td><strong>Protocol</strong></td><td><p>Select the protocol used to connect to the server. The protocols offered depend on the selected <em><strong>Application</strong></em>:</p><ul><li><strong>FTP</strong></li><li><strong>SFTP</strong> — Unavailable with <em><strong>Windows Explorer</strong></em>.</li><li><strong>SCP</strong> — Unavailable with <em><strong>Windows Explorer</strong></em> and <em><strong>FileZilla</strong></em>.</li><li><strong>Session</strong> — Opens a session saved in the application. Unavailable with <em><strong>Windows Explorer</strong></em>.</li><li><strong>HTTP</strong> — Unavailable with <em><strong>Windows Explorer</strong></em> and <em><strong>FileZilla</strong></em>.</li><li><strong>HTTPS</strong> — Unavailable with <em><strong>Windows Explorer</strong></em> and <em><strong>FileZilla</strong></em>.</li><li><strong>Amazon S3</strong> — Unavailable with <em><strong>Windows Explorer</strong></em> and <em><strong>FileZilla</strong></em>.</li></ul></td></tr><tr><td><strong>Local path</strong></td><td>The local directory opened in the application when the session starts. Unavailable when <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>.</td></tr><tr><td><strong>Encryption</strong></td><td><p>Select the encryption used for the FTP connection. Available only when <em><strong>Application</strong></em> is set to <em><strong>WinSCP</strong></em> and <em><strong>Protocol</strong></em> is set to <em><strong>FTP</strong></em> or <em><strong>Session</strong></em>:</p><ul><li><strong>No encryption</strong></li><li><strong>SSL/TLS implicit encryption</strong></li><li><strong>SSL explicit encryption</strong></li><li><strong>TLS explicit encryption</strong></li></ul></td></tr><tr><td><strong>Session</strong></td><td>The name of the session saved in FileZilla or WinSCP. Enter a name or select one from the list. Available and required only when <em><strong>Protocol</strong></em> is set to <em><strong>Session</strong></em>.</td></tr><tr><td><strong>Passive mode</strong></td><td>Use passive mode for the FTP connection. Available only when <em><strong>Application</strong></em> is set to <em><strong>WinSCP</strong></em> and <em><strong>Protocol</strong></em> is set to <em><strong>FTP</strong></em> or <em><strong>Session</strong></em>.</td></tr><tr><td><strong>Other parameters</strong></td><td>Additional command-line parameters passed to the application when the session starts.</td></tr></tbody></table>

### SSH key

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Private key</strong></td><td><p>Select where the private key used by WinSCP comes from:</p><ul><li><strong>No private key</strong></li><li><strong>File (local)</strong></li><li><strong>Embedded data</strong></li><li><strong>My personal SSH key</strong> — Click the edit button next to the list to modify it.</li></ul><p>Other options link the private key to another entry. The options offered depend on the data source and its settings.</p></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. Use the buttons in the field to clear the selection or, when allowed, to add a private key 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>


---

# 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/filezilla-winscp-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.
