> 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/smb-server-message-block.md).

# SMB (Server Message Block)

Configure SMB (Server Message Block) session settings in Remote Desktop Manager, including the host and port, username, domain, password, and share name.

This article details the many settings and options available for ***SMB (Server Message Block)*** 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. Click the browse button to select a folder, or click the add button to create a new one.</td></tr><tr><td><strong>Display</strong></td><td><p>How the entry opens:</p><ul><li><strong>Embedded (tabbed)</strong> — Opens the entry in a tab of the main window.</li><li><strong>Undocked</strong> — Opens the entry in a separate window. Additional lists let you choose the monitor and the virtual desktop where the window opens.</li></ul><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>Where the host of the entry comes from. <em><strong>Host configured</strong></em> uses the <em><strong>Host</strong></em> entered in the <em><strong>General</strong></em> tab. <em><strong>Linked</strong></em> uses a host entry from the vault selected in the <em><strong>Vault</strong></em> list. <em><strong>Inherited</strong></em> uses the host of a parent folder.</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>Domain</strong></em>, and <em><strong>Password</strong></em> fields 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 SMB server. Enter it or click the button to choose one from a list. Required unless the host comes from a linked or inherited host, in which case the field is unavailable.</td></tr><tr><td><strong>Port</strong></td><td>The port of the SMB server. The default port is <code>445</code>. Unavailable when the host comes from a linked or inherited host.</td></tr><tr><td><strong>Username</strong></td><td>The username used to connect to the SMB server. Available when <em><strong>Credentials</strong></em> is set to <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Domain</strong></td><td>The domain of the user account. Available when <em><strong>Credentials</strong></em> is set to <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Password</strong></td><td>The password of the user account. Available when <em><strong>Credentials</strong></em> is set to <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Share name</strong></td><td>The name of the share to open on the SMB server. Click the browse button to connect to the server with the credentials above and select a share from the list of available shares.</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/smb-server-message-block.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.
