DBeaver Documentation


Configuration files in DBeaver


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.


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

Configuration Description
License Management Configure DBeaver 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.

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

Other configuration files

The data-sources.json and tasks.json configuration files in DBeaver serve crucial roles, particularly when it comes to the portability of database connections and tasks configurations across different DBeaver installations.

Configuration file Capabilities
data-sources.json The value of data-sources.json lies in its ability to facilitate the migration of database connections from one DBeaver installation to another. This is particularly useful when moving to a new workstation, setting up a team member with the same database connections, or ensuring consistency across different environments for testing or development purposes.
tasks.json This file stores the configuration for various tasks, such as SQL scripts execution, data transfer operations, and other automated tasks. Similar to data-sources.json, tasks.json allows for the easy migration of configured tasks from one DBeaver instance to another.
Location of the other configuration files

The location of data-sources.json and tasks.json files is consistent across all operating systems, relative to the DBeaver workspace:

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

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