> 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/ribbon-menu-bar/file/settings/advanced.md).

# Advanced

Configure advanced Remote Desktop Manager settings covering debugging, authentication, diagnostics, privacy, and user interface behavior.

Use ***File – Settings – Advanced*** to control the behavior of the application with respect to the lower-level settings.

### Settings

{% tabs %}
{% tab title="Windows" %}
Use ***File*** – ***Settings*** – ***Advanced*** to control the behavior of the application with respect to the lower-level settings.

### Settings <a href="#settings" id="settings"></a>

| OPTION          | DESCRIPTION                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Debug level** | Set the level of debugging information that Remote Desktop Manager will capture. This should only be modified upon request from a Devolutions customer support technician as it might cause your system to slow down.                                                                                                                                                                                                                                                                           |
| **Logs**        | <p>The logs can be saved in a file or in a database file. Select between:<br></p><ul><li>Both: Logs will be saved in a text file and in a database file.</li><li>Database: Logs will be saved in a file named <code>RemoteDesktopManager.log.db</code>. The file is located in the installation folder of the application.</li><li>File: Logs will be saved in a file named <code>RemoteDesktopManager.log</code>. The file is located in the installation folder of the application.</li></ul> |

#### Application <a href="#application" id="application"></a>

| Option                                          | Description                                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Add folder in hierarchy during batch add**    | When adding folders in batches, depending on the option chosen, the folders will all be created at the same level or will be children of the previous folder.                                                                                                                                                                     |
| **Allow multiple instances**                    | Allow more than one instance of Remote Desktop Manager to run concurrently. Useful for a staging and production environment running[ different product versions](https://docs.devolutions.net/rdm/knowledge-base/how-to-articles/portable-remote-desktop-manager-version.md).                                                     |
| **Allow non-upgraded workspace**                | Allow Remote Desktop Manager to work on an older workspace that has not been upgraded.                                                                                                                                                                                                                                            |
| **Check focus content on RDP activation**       | If an RDP session requests the focus, it will pull Remote Desktop Manager to the foreground, focusing it.                                                                                                                                                                                                                         |
| **Focus content on application activation**     | Set focus on the last embedded session when the application is activated.                                                                                                                                                                                                                                                         |
| **Use Devolutions Updater**                     | Only modify this option upon request from our customer support team.                                                                                                                                                                                                                                                              |
| **Use ZipCrypto compression (not recommended)** | Enable this option to allow the ZipCrypto compression in Remote Desktop Manager. We do not recommend enabling this option. Here is a blog written by our security team about the subject: [Why you should never use the native .Zip Crypto in Windows](https://blog.devolutions.net/2020/08/why-you-should-never-use-zipcrypto/). |

#### Authentication <a href="#authentication" id="authentication"></a>

| Option                                                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Disable IME for password fields**                                            | Disable IME for password fields.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Disable OAuth context sharing**                                              | Prevent the PowerShell module from obtaining the OAuth context of the current workspace.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Lock integrated security: validate only against the domain context**         | The integrated security lock validates by default against the local machine and the domain context. You have the option to validate only against the domain. If enabled, Remote Desktop Manager will perform the ***LogonUser*** by using the domain in the username. The option affected is [Use this computer's credentials](https://github.com/Devolutions/RDM/tree/master/docs-products/rdm/ribbon-menu-bar/file/security/README.md#application-security-local) in ***Security – Lock***. By default, without this option enabled, Remote Desktop Manager will use ***Environment.MachineName*** which is the ***NetBIOS*** name of the local computer. |
| **Use authorization code flow for Devolutions Account and Devolutions Server** | When enabled, Remote Desktop Manager uses the OAuth 2.0 authorization code flow to sign in to Devolutions Account and Devolutions Server.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Use embedded browser for login**                                             | Allow login to Devolutions Server and Devolutions Cloud through an embedded browser. By default, workspaces check this setting and use the ***Embedded*** authentication mode. This can also be changed for specific workspaces by going to ***File*** – ***Workspaces***, and setting a different ***Authentication browser mode*** in the ***Advanced*** tab of the desired workspace.                                                                                                                                                                                                                                                                    |
| **Use the Windows sign-in dialog for Microsoft Entra ID**                      | Uses the Windows sign-in dialog (Windows account broker) for interactive Microsoft Entra ID sign-in, such as SQL Server workspaces using Azure AD Interactive authentication, Azure virtual machine synchronization, and Azure Bastion.                                                                                                                                                                                                                                                                                                                                                                                                                     |

#### Confirmation <a href="#confirmation" id="confirmation"></a>

| Option                                                      | Description                                                                     |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Disable prompt for confirmation on cancel in properties** | Enable to suppress the confirmation prompt when canceling the edit of an entry. |
| **Disable prompt for confirmation when browsing host**      | Disable the confirmation prompt when browsing to a host.                        |
| **Disable prompt for confirmation when closing navigation** | Suppress the confirmation prompt when closing the navigation.                   |

#### Diagnostic <a href="#diagnostic" id="diagnostic"></a>

| Option                                             | Description                                                                                                                                                                                                |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Disable multi-threaded loading**                 | This setting allows Remote Desktop Manager to use multiple threads to load the data. Disabling this option will decrease the performance.                                                                  |
| **Disable multi-threaded offline file**            | This setting allows Remote Desktop Manager to use multiple threads in the offline file. Disabling this option will decrease the performance.                                                               |
| **Disable resilient database connection handling** | Resilient database connection handling is a mechanism we put in place to retry certain database connections in Remote Desktop Manager to avoid certain errors. Some slowness can be expected when enabled. |
| **Disable stack trace**                            | Disable the stack trace details when an error occurs in Remote Desktop Manager. This is a security feature.                                                                                                |
| **Disable timed caches**                           | Disable temporary data storage.                                                                                                                                                                            |

#### Paths <a href="#paths" id="paths"></a>

| Option                                           | Description                                                                      |
| ------------------------------------------------ | -------------------------------------------------------------------------------- |
| **Always save screenshots to the default path**  | All screenshots taken are automatically saved to a predefined default directory. |
| **Use application directory for local playlist** | Use the installation folder to save the local playlist that has been created.    |
| **Use application directory for offline cache**  | Use the installation folder to save the offline cache file.                      |

#### Privacy <a href="#privacy" id="privacy"></a>

| Option                                | Description                                                                                                                          |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Disable AI assistant**              | Disable the AI assistant feature.                                                                                                    |
| **Disable in-app upselling**          | Disable in-app upselling.                                                                                                            |
| **Disable telemetry**                 | Disable the analysis of data or statistics. Telemetry is the equivalent of Google Analytics. Note that the statistics are anonymous. |
| **Enable support chat notifications** | Enable notifications from the support chat.                                                                                          |
| **No Internet connection**            | Disable the application from accessing the Internet.                                                                                 |

#### User interface <a href="#user-interface" id="user-interface"></a>

| Option                                               | Description                                                                                                                                                                                                                                                                     |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Disable layout restoration**                       | Disable manually configured tab layout and restore the layout settings on a Remote Desktop Manager restart.                                                                                                                                                                     |
| **Embed workspace web interface (experimental)**     | This option is used to perform certain actions, like user edition, directly within Remote Desktop Manager by opening the web interface in embedded mode, instead of opening externally. Note that this option is only supported by Devolutions Server.                          |
| **Hide last opened playlist in playlist management** | Hide the last opened playlist at startup in the playlist dialog.                                                                                                                                                                                                                |
| **Keep View Password window on top**                 | Force the ***View Password*** window to display on top of all the Remote Desktop Manager windows.                                                                                                                                                                               |
| **Sort numbers before spaces in entry names**        | Restores the previous sort order of entry names that mix text and numbers. By default, entry names are sorted like in Windows File Explorer (for example, *shire*, *shire scp*, *shire2*). With this option, numbers are sorted before spaces (*shire*, *shire2*, *shire scp*). |
| **Use old entry sort**                               | Use the old entry sort from previous version of Remote Desktop Manager.                                                                                                                                                                                                         |
| **Use username format in password list dashboard**   | Displays usernames in the Password List dashboard using the configured username format.                                                                                                                                                                                         |

#### Other options <a href="#other-options" id="other-options"></a>

| Option                                                              | Description                                                                                                                                                                                                |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Submit ticket mode**                                              | Choose submit ticket mode: Default / Send a ticket to support / Forum ticket                                                                                                                               |
| **Force "localhost" when using VPN dynamic port**                   | Force the use of "localhost" when using the VPN dynamic port.                                                                                                                                              |
| **Last comment count**                                              | If an entry is set up to ask for a comment on opening/closing, a list of the last comments will be displayed to help the user. Set the number of last comments that will be saved then shown in that list. |
| **Confirm on multiple sessions open if open count is greater than** | Select a target number (1 to 9999) where mass opening sessions will demand confirmation.                                                                                                                   |
| **Close View password and OTP windows after (minutes)**             | Automatically closes the ***View password*** and one-time password windows after the specified number of minutes (1 to 720).                                                                               |

#### Information <a href="#information" id="information"></a>

A separate **Information** tab displays read-only details about the current configuration:

| OPTION                             | DESCRIPTION                                                                              |
| ---------------------------------- | ---------------------------------------------------------------------------------------- |
| **Creation date**                  | The date the current configuration was created.                                          |
| **Option source**                  | The source of the loaded configuration (for example, the local file or database).        |
| **Option path**                    | The path to the configuration file or folder. Click it to open the location.             |
| **Reset configuration to default** | Resets the application configuration to its default values and restarts the application. |
| {% endtab %}                       |                                                                                          |

{% tab title="macOS" %}

<table><thead><tr><th width="135">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Debug level</strong></td><td>Set the level of debugging information that Remote Desktop Manager macOS will capture. This should only be modified upon request from a Devolutions customer support technician as it might cause your system to slow down.</td></tr><tr><td><strong>Logs</strong></td><td><p>The logs can be saved in a file or in a database file. Select between:</p><ul><li><em><strong>Both</strong></em>: Logs will be saved in a text file and in a database file.</li><li><em><strong>Database</strong></em>: Logs will be saved in a file named RemoteDesktopManager.log.db. The file is located in the installation folder of the application.</li><li><em><strong>File</strong></em>: Logs will be saved in a file named RemoteDesktopManager.log. The file is located in the installation folder of the application.</li></ul></td></tr></tbody></table>

#### Application <a href="#application-macos" id="application-macos"></a>

| OPTION                                                       | DESCRIPTION                                                                                        |
| ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| **Allow multiple instances**                                 | Allow more than one instance of Remote Desktop Manager macOS to run concurrently. Not recommended. |
| **Automatically open file location after session recording** | After session recording, opens the destination folder.                                             |
| **Disable AppleScript**                                      | AppleScript is enabled by default; disable it here if desired.                                     |
| **Favor low-power GPU**                                      | Favor the use of the GPU that requires the least power, if many GPUs are available.                |
| **Start agent on application start**                         | The SSH key agent starts when you open Remote Desktop Manager macOS.                               |

#### Authentication <a href="#authentication-macos" id="authentication-macos"></a>

| OPTION                                                                         | DESCRIPTION                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Disable IME for password fields**                                            | Switch to an English (ABC) keyboard while a password field has the focus, then restore the previous input source when the focus leaves the field. Prevents input methods, such as Chinese, Japanese, or Korean input, from altering what is typed in password fields. Disabled by default. |
| **Disable OAuth context sharing**                                              | Prevent the PowerShell module from obtaining the OAuth context of the current workspace.                                                                                                                                                                                                   |
| **Use authorization code flow for Devolutions Account and Devolutions Server** | When enabled, Remote Desktop Manager macOS uses the OAuth 2.0 authorization code flow to sign in to Devolutions Account and Devolutions Server.                                                                                                                                            |
| **Use embedded browser for login**                                             | Allow login to Devolutions Server and Devolutions Cloud through an embedded browser.                                                                                                                                                                                                       |

#### Confirmation <a href="#confirmation-macos" id="confirmation-macos"></a>

| OPTION                                  | DESCRIPTION                                                                                                                                             |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Disable logoff confirmation message** | When pressing the logoff button in an embedded RDP session, Remote Desktop Manager will disconnect the session without the logoff confirmation message. |

#### Connection <a href="#connection-macos" id="connection-macos"></a>

| OPTION                                         | DESCRIPTION                                                                |
| ---------------------------------------------- | -------------------------------------------------------------------------- |
| **Auto-close embedded tab on disconnect**      | When a session is disconnected, the embedded tab will automatically close. |
| **Automatically go offline on network change** | When changing network, Remote Desktop Manager macOS goes in Offline mode.  |

#### Diagnostic <a href="#diagnostic-macos" id="diagnostic-macos"></a>

| OPTION                     | DESCRIPTION                                                                     |
| -------------------------- | ------------------------------------------------------------------------------- |
| **Disable timed caches**   | Disable temporary data storage.                                                 |
| **Enable session logging** | Record and track activities and interactions with Remote Desktop Manager macOS. |

#### Privacy <a href="#privacy-macos" id="privacy-macos"></a>

| OPTION                                         | DESCRIPTION                                                                                        |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Disable AI assistant**                       | Disable the AI assistant feature.                                                                  |
| **Disable all gravatars**                      | Disable all Gravatar images to improve performance.                                                |
| **Disable compromised password (pwned) check** | Disable pwned check if not forced in ***Administration – System Settings – Password Validation***. |
| **Disable telemetry**                          | Disable the telemetry data collection.                                                             |
| **Disable user gravatar**                      | Disable Gravatar images in ***Administration – Users*** to improve performance.                    |

#### User interface <a href="#user-interface-macos" id="user-interface-macos"></a>

| OPTION                                        | DESCRIPTION                                                                                                                                                                                                      |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Disable custom images**                     | Disable the loading of any custom images in the tree view. Too many custom images could dramatically increase the size of the data source and increase the load time at the same time.                           |
| **Get file icons from their apparent type**   | The file icon will be “deduced“ from the file extension rather than asking the OS to resolve the image for the file directly. Only works for ***FTP***, ***SFTP***, ***SCP***, and ***WebDAV*** session entries. |
| **Sort numbers before spaces in entry names** | Restores the previous sort order of entry names that mix text and numbers, where numbers are sorted before spaces.                                                                                               |

#### Other options <a href="#other-options-macos" id="other-options-macos"></a>

| OPTION                                                              | DESCRIPTION                                                                                                                                                                                                            |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Force "localhost" when using VPN dynamic port**                   | Force the use of "localhost" when using the VPN dynamic port: ***Yes*** or ***No***.                                                                                                                                   |
| **Confirm on multiple sessions open if open count is greater than** | Select a target number (1 to 9999) where mass opening sessions will demand confirmation.                                                                                                                               |
| **Offline engine**                                                  | Determine which local storage engine Remote Desktop Manager macOS uses to save and manage data when working offline: ***Default (SQLite)***, ***SQLite***, or ***Memory***. Changes are effective at the next restart. |

#### Information <a href="#information-macos" id="information-macos"></a>

A separate **Information** tab displays the creation date of the current configuration and the path to the configuration file or folder (click it to open the location). It also contains the **Reset configuration to default** button, which resets the application configuration to its default values and restarts the application.
{% endtab %}
{% endtabs %}


---

# 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/ribbon-menu-bar/file/settings/advanced.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.
