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

# ControlR

Configure ControlR session entries in Remote Desktop Manager, including the server URL, credentials, connection mode and device ID.

This article details the settings available for ***ControlR*** session entries in Remote Desktop Manager. A ***ControlR*** entry connects to a ControlR server to control a device, open a terminal, browse its files, or display the ControlR web interface.

{% hint style="info" %}
***ControlR*** entries are available on Windows and macOS. The web pages of ControlR open in the embedded web browser, which requires the Microsoft Edge WebView2 runtime on Windows.
{% 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>How the entry opens: <em><strong>Embedded (tabbed)</strong></em> or <em><strong>Undocked</strong></em>.</td></tr><tr><td><strong>Credentials</strong></td><td>How the credentials of the entry are provided. Select a credential mode from the list.</td></tr></tbody></table>

### General

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>URL</strong></td><td>The address of the ControlR server. Required. It must be a valid <code>http</code> or <code>https</code> URL. Select the navigate button to open the URL in the browser.</td></tr><tr><td><strong>Use "My account settings"</strong></td><td>Uses the ControlR username and password saved in <em><strong>File</strong></em> – <em><strong>My account settings</strong></em> instead of the credentials of the entry. Cleared by default. Hidden when a policy disables <em><strong>My account settings</strong></em>.</td></tr><tr><td><strong>Username</strong></td><td>The ControlR username. Disabled when <em><strong>Use "My account settings"</strong></em> is selected or when the credentials come from another entry.</td></tr><tr><td><strong>Password</strong></td><td>The ControlR password. Disabled in the same cases as <em><strong>Username</strong></em>, and when the <em><strong>Disable password saving in vaults</strong></em> system setting is enabled.</td></tr><tr><td><strong>Mode</strong></td><td><p>What the entry opens:</p><ul><li><strong>Prompt on connection</strong> — asks for the mode each time the entry opens.</li><li><strong>Dashboard</strong> — the ControlR dashboard of Remote Desktop Manager, with the devices of the account.</li><li><strong>Remote control</strong></li><li><strong>Terminal</strong></li><li><strong>File system</strong></li><li><strong>Remote access</strong> — the device access page of the ControlR web interface.</li><li><strong>Overview</strong> — the ControlR web interface. This is the default value.</li><li><strong>Chat</strong></li><li><strong>Remote logs</strong></li></ul></td></tr><tr><td><strong>Device ID</strong></td><td>The ID of the ControlR device. Select the browse button to sign in to ControlR and choose a device from the list. Hidden when <em><strong>Mode</strong></em> is <em><strong>Overview</strong></em> or <em><strong>Dashboard</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/controlr.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.
