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

# General (macOS)

Configure the General settings of Remote Desktop Manager on macOS, including clipboard, startup, updates, hotkeys, warnings, paths, proxy, recording, and AI.

In Remote Desktop Manager on macOS, go to ***File*** – ***Settings*** – ***General*** to configure the general behavior of the application. The settings window can also be opened from ***Remote Desktop Manager*** – ***Settings*** in the menu bar at the top of the screen.

The ***General*** tab lists the following pages in its left pane.

### Application

<table><thead><tr><th width="254">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Allow multiple connections (default)</strong></td><td>Sets whether an entry that is already open can be opened again in another tab: <em><strong>Yes</strong></em> or <em><strong>No</strong></em> (default). With <em><strong>No</strong></em>, opening the entry again brings its existing session to the front.</td></tr><tr><td><strong>Hide application on copy</strong></td><td>In the <em><strong>Clipboard</strong></em> section. Hides Remote Desktop Manager after a value such as a username or a password is copied, to give direct access to the application where the value is pasted. Disabled by default.</td></tr></tbody></table>

### Application startup

<table><thead><tr><th width="254">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Startup window state</strong></td><td>Sets the state of the main window when Remote Desktop Manager starts: <em><strong>Last saved</strong></em> (default), <em><strong>Minimized</strong></em>, <em><strong>Maximized</strong></em>, or <em><strong>Full screen</strong></em>.</td></tr><tr><td><strong>Release channel</strong></td><td>In the <em><strong>Auto-update</strong></em> section. Sets the release channel used for updates: <em><strong>Current</strong></em> (default), <em><strong>Beta</strong></em>, or <em><strong>Extended maintenance</strong></em>. For more information, see <a href="/rdm/concepts/intermediate-concepts/extended-maintenance.md">Extended maintenance</a>.</td></tr><tr><td><strong>Frequency</strong></td><td>In the <em><strong>Auto-update</strong></em> section. Sets how often Remote Desktop Manager checks for updates: <em><strong>Once a month</strong></em> (default), <em><strong>Once a week</strong></em>, <em><strong>Once a day</strong></em>, or <em><strong>Manual checks only</strong></em>.</td></tr></tbody></table>

### Application close

The ***On exit*** section contains the following options. All three are enabled by default.

<table><thead><tr><th width="339">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Confirm before exiting</strong></td><td>Asks for confirmation when closing Remote Desktop Manager.</td></tr><tr><td><strong>Verify open sessions on close</strong></td><td>Displays a warning when sessions are still open while closing Remote Desktop Manager.</td></tr><tr><td><strong>Verify checked-out sessions on close</strong></td><td>Displays a warning when entries are still checked out while closing Remote Desktop Manager.</td></tr></tbody></table>

### Advanced

The ***Advanced*** page contains the ***Clipboard*** settings. For the Windows and Linux settings, see [Clipboard](/rdm/ribbon-menu-bar/file/settings/application/clipboard.md).

<table><thead><tr><th width="254">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Clipboard copy method</strong></td><td><p>Sets how Remote Desktop Manager copies a single value, such as a password, to the clipboard:</p><ul><li><em><strong>Legacy</strong></em> (default): The value stays in the clipboard until another value replaces it.</li><li><em><strong>Paste once (secure)</strong></em>: Remote Desktop Manager keeps the value in the clipboard until the <em><strong>Clear clipboard delay</strong></em> elapses, then clears the clipboard.</li></ul><p><em><strong>Copy username and password</strong></em> always uses a sequence, whatever the copy method: the clipboard holds the username first, and each time an application reads the clipboard, the clipboard moves to the next value. After the last value is read, the clipboard is cleared.</p></td></tr><tr><td><strong>Clear clipboard delay</strong></td><td>Sets the delay, in seconds, after which Remote Desktop Manager clears a value copied with <em><strong>Paste once (secure)</strong></em>. Enabled by default, with a delay of 10 seconds. Accepts values from 10 to 300. When this option is disabled, the copied value stays in the clipboard.</td></tr></tbody></table>

### Hotkeys

<table><thead><tr><th width="322">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Show/Hide all windows with a system-wide hotkey</strong></td><td>Shows or hides all the windows of Remote Desktop Manager when the key combination set in the <em><strong>Hotkey</strong></em> field is pressed, from any application. Disabled by default. The default key combination is <kbd>Option</kbd>+<kbd>Cmd</kbd>+<kbd>\</kbd>.</td></tr><tr><td><strong>Show/Hide Find Quickly window with a system-wide hotkey</strong></td><td>Shows or hides the <em><strong>Find Quickly</strong></em> window when the key combination set in the <em><strong>Hotkey</strong></em> field is pressed, from any application. Disabled by default. The default key combination is <kbd>Option</kbd>+<kbd>Cmd</kbd>+<kbd>`</kbd>.</td></tr><tr><td><strong>Hotkey</strong></td><td>Key combination of the hotkey. Click the field, then press the new key combination.</td></tr></tbody></table>

### Action center

The ***Dashboard warnings*** section contains the following options.

<table><thead><tr><th width="237">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Show license warnings</strong></td><td>Shows the license warnings, such as expired or expiring licenses, in the dashboard. Enabled by default.</td></tr><tr><td><strong>Restore license warnings</strong></td><td>Shows again the license warnings that were hidden. Available only when license warnings were hidden.</td></tr><tr><td><strong>Restore other warnings</strong></td><td>Shows again the other dashboard warnings that were hidden, such as the warnings about unsecured HTTP connections, network drives, offline data, or a high entry count. Available only when such warnings were hidden.</td></tr></tbody></table>

### Paths

<table><thead><tr><th width="199">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Default templates</strong></td><td>Folder where the default templates are stored.</td></tr><tr><td><strong>Recording</strong></td><td>Folder where session recordings are saved.</td></tr><tr><td><strong>Application log</strong></td><td>In the <em><strong>Advanced</strong></em> section. Folder where the application log files are stored.</td></tr></tbody></table>

### Proxy

Click ***Proxy settings*** to configure the proxy used by Remote Desktop Manager. Changes are applied at the next restart.

<table><thead><tr><th width="250">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Proxy mode</strong></td><td><em><strong>No Proxy</strong></em> (default) or <em><strong>Custom</strong></em>. Click <em><strong>Test</strong></em> to test the connection with the selected settings.</td></tr><tr><td><strong>Address</strong></td><td>Address of the proxy server. Available with the <em><strong>Custom</strong></em> mode.</td></tr><tr><td><strong>Port</strong></td><td>Port of the proxy server. Available with the <em><strong>Custom</strong></em> mode.</td></tr><tr><td><strong>Bypass proxy server on local addresses</strong></td><td>Does not use the proxy server for local addresses. Available with the <em><strong>Custom</strong></em> mode.</td></tr><tr><td><strong>Do not use proxy server for addresses beginning with</strong></td><td>Addresses that do not use the proxy server. Use semicolons (;) to separate entries. Available with the <em><strong>Custom</strong></em> mode.</td></tr><tr><td><strong>Credential mode</strong></td><td>Credentials used to authenticate on the proxy server: <em><strong>No credentials</strong></em> (default) or <em><strong>Custom</strong></em>. With <em><strong>Custom</strong></em>, enter the <em><strong>Username</strong></em>, <em><strong>Domain</strong></em>, and <em><strong>Password</strong></em>. Available with the <em><strong>Custom</strong></em> proxy mode.</td></tr></tbody></table>

### Recording

<table><thead><tr><th width="198">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Frame rate</strong></td><td>Number of frames per second (fps) of the recordings, from 1 to 5. The default value is 1.</td></tr><tr><td><strong>Video quality</strong></td><td>Quality of the recordings, from 1 to 10. Values under 5 are shown as <em><strong>Low</strong></em>, 5 as <em><strong>Medium</strong></em> (default), and values over 5 as <em><strong>High</strong></em>.</td></tr><tr><td><strong>Resolution</strong></td><td>Resolution of the recordings, from 640x480 to 1920x1200. The default value is 1024x768.</td></tr><tr><td><strong>SSH recording mode</strong></td><td>Format of the SSH session recordings: <em><strong>Video (.webm)</strong></em>, <em><strong>Terminal playback (.trp)</strong></em> (default), or <em><strong>Asciicast (.cast)</strong></em>.</td></tr></tbody></table>

### Custom variables

Lists the custom variables with their ***Name*** and ***Value***. Use ***Add***, ***Edit***, and ***Delete*** to manage the list, and ***Export*** and ***Import*** to transfer the variables in a JSON file. For more information, see [Manage custom variables](/rdm/knowledge-base/knowledge-base-articles/manage-custom-variables.md).

### AI

The ***AI*** page configures the ***AI assistant***. This page is not displayed when the AI assistant is disabled by a policy, by the workspace settings, or by the ***Disable AI assistant*** setting. For more information, see [Set up an AI assistant](/rdm/knowledge-base/how-to-articles/set-up-an-ai-assistant.md).

The settings are split across the ***General***, ***MCP servers***, and ***Skills*** tabs. The ***MCP servers*** and ***Skills*** tabs are displayed once a provider is selected.

#### General

<table><thead><tr><th width="200">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Provider</strong></td><td><p>Provider of the AI features: <em><strong>None</strong></em> (default), <em><strong>GitHub Copilot</strong></em> (recommended), <em><strong>Azure AI Inference</strong></em>, <em><strong>Azure OpenAI</strong></em>, <em><strong>Claude (Anthropic)</strong></em>, <em><strong>Custom</strong></em>, <em><strong>Gemini</strong></em>, <em><strong>Mistral AI</strong></em>, <em><strong>Ollama</strong></em>, or <em><strong>OpenAI</strong></em>.</p><p>With <em><strong>GitHub Copilot</strong></em>, click <em><strong>Connect with GitHub</strong></em> to sign in. With <em><strong>Custom</strong></em>, click <em><strong>Configure</strong></em> to set up the provider.</p></td></tr><tr><td><strong>Endpoint</strong></td><td>API endpoint of the provider. Available with <em><strong>Azure AI Inference</strong></em>, <em><strong>Azure OpenAI</strong></em>, <em><strong>Mistral AI</strong></em>, <em><strong>Ollama</strong></em>, and <em><strong>OpenAI</strong></em>.</td></tr><tr><td><strong>API key</strong></td><td>API key used to authenticate with the provider. Not available with <em><strong>GitHub Copilot</strong></em>, <em><strong>Custom</strong></em>, and <em><strong>Ollama</strong></em>.</td></tr><tr><td><strong>Model</strong> or <strong>Deployment</strong></td><td>Model to use, or the deployment with <em><strong>Azure OpenAI</strong></em>. Click the refresh icon to reload the list of models.</td></tr><tr><td><strong>Reasoning effort</strong></td><td>Reasoning effort of the model. Available only with the models that support it.</td></tr><tr><td><strong>Enable tools</strong></td><td>Allows the AI assistant to use the MCP servers as tools. Enabled by default.</td></tr><tr><td><strong>Chats panel position</strong></td><td>Side of the AI assistant where the chats panel is displayed: <em><strong>Left</strong></em> or <em><strong>Right</strong></em> (default).</td></tr><tr><td><strong>Conversation width</strong></td><td>Width of the conversation in the AI assistant: <em><strong>Full</strong></em> or <em><strong>Centered</strong></em> (default).</td></tr><tr><td><strong>Languages</strong></td><td>In the <em><strong>Translate</strong></em> section. Click <em><strong>Edit</strong></em> to select the languages offered for translations.</td></tr></tbody></table>

#### MCP servers

Lists the MCP (Model Context Protocol) servers available to the AI assistant, with their ***Name***, ***Type***, and ***Details*** (URL or command). Use the checkbox of a server to enable or disable it, and ***Add***, ***Edit***, and ***Remove*** to manage the list. The servers included with Remote Desktop Manager cannot be edited or removed.

#### Skills

Lists the folders where Remote Desktop Manager looks for AI skills. Use ***Add folder*** and ***Remove*** to manage the list, and ***Preview discovered skills*** to see the skills found in these folders.


---

# 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/general-macos.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.