Skip to content

Admin Preference Restrictions

DBeaverDevOps edited this page Apr 10, 2024 · 3 revisions

Table of contents

Overview

This guide outlines the steps for enhancing security and control in DBeaver by restricting specific functionalities.

For Windows, Mac, and Linux, restrictions in the dbeaver.ini file can be implemented, while Windows users can also leverage the Registry for additional control.

Tip: Detailed instructions on finding dbeaver.ini are available in our article.

Follow the appropriate steps based on your operating system and preference.

Modifying the DBeaver configuration file

  1. Navigate to the directory containing the dbeaver.ini file.
  2. Use a text editor to open the configuration file.
  3. Locate the -vmargs line within the file.
  4. Add the desired settings from the Configuration options, ensuring each setting is preceded by -D (for instance -Dpolicy.data.export.disabled = true) and placed below the -vmargs line.
  5. Save the edited file.
  6. Restart DBeaver to apply changes.

Using Windows Registry

  1. Open the Registry Editor by typing regedit in the Run dialog (Win + R).
  2. Navigate to the following path in the Registry: HKEY_CURRENT_USER\Software\DBeaver Corp\DBeaver\policy
  3. Create a new value for each setting, from the Configuration options based on desired restrictions.
  4. Exit the Registry Editor and restart DBeaver to apply the changes.

Important: Editing the Windows Registry can significantly affect your system. Always make sure to back up the registry before making any changes. For more information on how to work with the Windows Registry, refer to the Microsoft Documentation on Registry Editing.

Configuration options

This section consolidates the configuration options, applicable through Windows Registry keys and as settings in the DBeaver configuration file.

General system restrictions
Registry key/Variable Name Type Default value Allowed values Description
policy.data.export.disabled DWORD/Boolean 0/false 0/false, 1/true Restricts ability to export data from databases.
policy.software.install.disabled DWORD/Boolean 0/false 0/false, 1/true Blocks ability to install new software and access the Eclipse marketplace.
policy.software.update.disabled DWORD/Boolean 0/false 0/false, 1/true Prevents ability to check for DBeaver updates.
Master password policy settings
Registry key/Variable Name Type Default value Allowed values Description
policy.master.password.disable DWORD/Boolean 1/true 0/false, 1/true Disables the requirement for a master password.
policy.master.password.policy REG_SZ/String {"minLength": 8, "minLetterCount": 1, "minNumberCount": 1, "minSymbolCount": 0, "requireMixedCase": true} {"minLength": int, "minLetterCount": int, "minNumberCount": int, "minSymbolCount": int, "requireMixedCase": boolean} Specifies the master password policy configuration. This is an optional setting, applicable only when the policy.master.password.disable policy is enabled.

minLength sets the minimum length,
minLetterCount determines the minimum number of letters,
minNumberCount establishes the minimum number of digits,
minSymbolCount sets the minimum number of symbols,
requireMixedCase sets if mixed case letters are required.

DBeaver Desktop Documentation

General User Guide

Database Management

DBeaver PRO

Databases support

Customizing DBeaver

Troubleshooting

Admin Guide

License management

Tutorials

Development

Clone this wiki locally