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

# KeePass

Configure KeePass credential entries in Remote Desktop Manager, including plugin or direct mode, database, key file, and how the KeePass entry is selected.

This article details the many settings and options available for KeePass credential 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.</td></tr></tbody></table>

### Database

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Mode</strong></td><td><p>Select how Remote Desktop Manager accesses the KeePass database. The other settings of this tab depend on the selected mode:</p><ul><li><strong>Direct</strong></li><li><strong>Plugin</strong></li></ul><p><em><strong>Plugin</strong></em> mode is not supported on macOS and Linux.</p></td></tr><tr><td><strong>Database</strong></td><td>In <em><strong>Plugin</strong></em> mode, the KeePass database to use. It shows <em><strong>KeePass current database</strong></em> unless <em><strong>Set database path manually</strong></em> is checked.<br><br>In <em><strong>Direct</strong></em> mode, the path of the KeePass database file. This field is required unless <em><strong>Use "My account settings"</strong></em> is checked, in which case it is disabled. The browse button is hidden when <em><strong>Open from URL</strong></em> is checked.</td></tr><tr><td><strong>Set database path manually</strong></td><td>Available in <em><strong>Plugin</strong></em> mode. When checked, you can select a specific database file in the <em><strong>Database</strong></em> field instead of using the KeePass current database. The <em><strong>Database</strong></em> field is then required.</td></tr><tr><td><strong>Install plugin</strong></td><td>Available in <em><strong>Plugin</strong></em> mode. Installs the Remote Desktop Manager plugin in KeePass. The status of the plugin is displayed above the button: <em><strong>KeePass plugin is installed</strong></em>, <em><strong>KeePass plugin is not installed</strong></em>, or <em><strong>KeePass plugin is out of date</strong></em>. The button is unavailable on macOS and Linux, and when the installed KeePass version is not supported. Click the help icon next to it for <em><strong>More information (installation and required settings)</strong></em>.</td></tr><tr><td><strong>Use "My account settings"</strong></td><td>Available in <em><strong>Direct</strong></em> mode. When checked, the entry uses the KeePass settings configured in <em><strong>My account settings</strong></em> instead of the <em><strong>Database</strong></em>, <em><strong>Password</strong></em>, and <em><strong>Key file</strong></em> fields. While it is checked, <em><strong>Database</strong></em>, <em><strong>Open from URL</strong></em>, <em><strong>Password</strong></em>, <em><strong>Key file</strong></em>, and <em><strong>Always ask for password</strong></em> are disabled. This option is hidden when a policy disables <em><strong>My account settings</strong></em>.</td></tr><tr><td><strong>Open from URL</strong></td><td>Available in <em><strong>Direct</strong></em> mode. When checked, the database is opened from a URL entered in the <em><strong>Database</strong></em> field.</td></tr><tr><td><strong>Server credentials</strong></td><td>Available in <em><strong>Direct</strong></em> mode when <em><strong>Open from URL</strong></em> is checked. Click to enter the username and password used to access the server hosting the database. Hidden when <em><strong>Use "My account settings"</strong></em> is checked.</td></tr><tr><td><strong>Password</strong></td><td>Available in <em><strong>Direct</strong></em> mode. Enter the password of the KeePass database. Disabled when <em><strong>Use "My account settings"</strong></em> or <em><strong>Always ask for password</strong></em> is checked.</td></tr><tr><td><strong>Key file</strong></td><td>Available in <em><strong>Direct</strong></em> mode. Select the key file of the KeePass database, if it uses one.</td></tr><tr><td><strong>Always ask for password</strong></td><td>Available in <em><strong>Direct</strong></em> mode. When checked, the database password is not saved in the entry and users are prompted for it when the entry is used.</td></tr></tbody></table>

### Entry

Select how the entry finds its KeePass credential from the drop-down list at the top of the tab:

* ***Default (specific UUID)***: The entry always uses one specific KeePass entry.
* ***Name filtering***: The entry looks up the KeePass entry by name.
* ***Always prompt with list***: The entry prompts users with a list of KeePass entries to choose from every time it is used.

**Default method**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>UUID</strong></td><td>The unique identifier of the selected KeePass entry. Click the <em><strong>Browse</strong></em> button to select the entry from the database. This field is required.</td></tr><tr><td><strong>Name</strong></td><td>The name of the selected KeePass entry, filled in automatically when an entry is selected.</td></tr></tbody></table>

**Name filtering method**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>Enter the name to search for in the KeePass database. This field is required. Variables are allowed. If there is only one match, it is chosen. If there are many, users are prompted to choose one when the entry is used.</td></tr><tr><td><strong>Mode</strong></td><td><p>Select how the name is matched:</p><ul><li><strong>Default</strong></li><li><strong>Exact match</strong></li></ul></td></tr><tr><td><strong>Case sensitivity</strong></td><td><p>Select whether the name match is case sensitive:</p><ul><li><strong>Default</strong></li><li><strong>Yes</strong></li></ul></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/keepass.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.
