Skip to content

Configuration files

DBeaver utilizes several configuration files to tailor the application to user needs. These files include:

  • dbeaver.ini
  • data-sources.json
  • tasks.json

Configuration files

Each of the listed files serves a specific purpose, from storing data sources and tasks to overall application settings.

dbeaver.ini

Through modifications to dbeaver.ini, you can apply licenses, manage drivers, enhance security, adjust user interface settings, and more.

Configuration Description
License Management Configure Enterprise Edition with a specific license.
Driver Management Manage and automate the provisioning of database drivers.
Administrative Preference Restrictions Implement restrictions to enhance application security and control over available functionalities.
AI-Smart Assistance Control the AI-Smart Assistance feature, including the option to disable it.
Command-Line Parameters Customize DBeaver startup and operational parameters through the command line.
JDBC Tracing Enable tracing for JDBC operations to diagnose and troubleshoot issues.

Tip

DBeaver also utilizes preference files to further customize and optimize the user experience. These preference files allow users to fine-tune the application settings and behaviors according to their specific needs.
For detailed information, refer to the Admin manage preferences article.

How to Locate the dbeaver ini

The dbeaver.ini file's location varies depending on the operating system and the method of installation. As a general rule, you can find dbeaver.ini in the directory where DBeaver is installed. For macOS, specifically, it is located in the Contents/Eclipse subfolder of the application.

Here are the common locations based on the operating system and installation method:

Operating System Location of dbeaver.ini
macOS ./Applications/[DBeaver Edition].app/Contents/Eclipse/dbeaver.ini
Linux /usr/share/dbeaver-[edition]/dbeaver.ini for installations via .deb, .rpm, or PPA packages.
Windows C:\Program Files\[DBeaver Edition]\dbeaver.ini for a default installation.

Info

Replace [DBeaver Edition] with your specific installation, such as Dbeaver for Community Edition, DBeaverLite for Lite Edition, DBeaverEE for Enterprise Edition, and DBeaverUltimate for Ultimate Edition.

Other configuration files

The data-sources.json and tasks.json files store database connection and task configurations. You can also use these files to transfer configurations between DBeaver installations.

Configuration file Capabilities
data-sources.json Stores database connection configurations and can also be used to transfer them between DBeaver installations
tasks.json Stores task configurations, such as SQL script execution, data transfer operations, and other automated tasks, and can also be used to transfer them between DBeaver installations

Note

Saved credentials may require re-entry or migration, depending on the selected credential storage provider.

Location of the other configuration files

The data-sources.json and tasks.json files are stored in project metadata under the DBeaverData product data root. The default workspace is DBeaverData/workspace6, and each project's configuration files are under DBeaverData/workspace6/<project>/.dbeaver/:

  • data-sources.json: DBeaverData/workspace6/General/.dbeaver/data-sources.json
  • tasks.json: DBeaverData/workspace6/General/.dbeaver/tasks.json

Tip

Detailed instructions on finding your workspace are available in Workspace Location article.

Driver files

DBeaver stores driver .jar files in two locations depending on how the driver was installed:

Tip

To find the exact path for a specific driver, open Database -> Driver Manager, select the driver, click Edit -> Libraries tab, then double-click the .jar file.

Bundled drivers

OS Path
Windows C:\Program Files\[DBeaver Edition]\drivers\
macOS /Applications/[DBeaver Edition].app/Contents/Eclipse/drivers/
Linux /usr/share/dbeaver-[edition]/drivers/

Maven-downloaded drivers

OS Path
Windows %APPDATA%\DBeaverData\drivers\maven\maven-central\
macOS ~/Library/DBeaverData/drivers/maven/maven-central/
Linux $XDG_DATA_HOME/DBeaverData/drivers/maven/maven-central/

Tip

For information on workspace location, see Workspace Location.