18 Admin Manage Drivers
dbeaver-devops edited this page 2026-04-14 07:06:54 +00:00

Table of contents

You can customize drivers configuration in the workspace/.metadata/.config/drivers.xml file.

Configure drivers with pre-installed jars

If you have some pre-installed jar files you can reference them in drivers.xml.

Example:

<library type="jar" path="absolute-jar-folder-path\driver-jar.jar" custom="true"/>

You can use the following variables to specify relative paths:

Variable Meaning
${drivers_home} Standard DBeaver drivers location - ($workspace/drivers by default)
${dbeaver_home} DBeaver installation folder
${home} User home folder
${workspace} DBeaver workspace path. For instance: <library type="jar" path="${workspace}\drivers\my-driver.jar" custom="true"/>

Full drivers.xml example:

<?xml version="1.0" encoding="UTF-8"?>
<drivers>

	<provider id="postgresql">
		<driver id="postgres-jdbc" custom="false" embedded="false" name="PostgreSQL" class="org.postgresql.Driver" url="jdbc:postgresql://{host}[:{port}]/[{database}]" port="5432" description="PostgreSQL standard driver">
			<library type="jar" path="maven:/org.postgresql:postgresql:RELEASE" custom="false" version="42.2.20">
				<file id="org.postgresql:postgresql" version="42.2.20" path="${drivers_home}/maven/maven-central/org.postgresql/postgresql-42.2.20.jar"/>
			</library>
			<library type="jar" path="maven:/net.postgis:postgis-jdbc:RELEASE" custom="false" version="2.5.0">
				<file id="net.postgis:postgis-jdbc" version="2.5.0" path="${drivers_home}/maven/maven-central/net.postgis/postgis-jdbc-2.5.0.jar"/>
			</library>
			<library type="jar" path="maven:/net.postgis:postgis-jdbc-jtsparser:RELEASE" custom="false" version="2.5.0">
				<file id="net.postgis:postgis-jdbc-jtsparser" version="2.5.0" path="${drivers_home}/maven/maven-central/net.postgis/postgis-jdbc-jtsparser-2.5.0.jar"/>
			</library>
		</driver>
	</provider>
	
</drivers>

Provide predefined drivers configuration

In some cases you may need to provide a driver's configuration or driver jar files for a number of DBeaver installations automatically.

This can be done by adding a special parameter in the dbeaver.ini file: -Ddbeaver.drivers.configuration-file=c:\some-path\dbeaver-drivers-config.xml

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

This file has the same structure as drivers.xml file (see above) and it will be loaded before drivers.xml.

Example:

If you need to configure only the jar path then it may look like this:

<?xml version="1.0" encoding="UTF-8"?>
<drivers>
  <provider id="generic">
    <driver id="netezza">
      <library type="lib" path="X:\jdbc-drivers\netezza-jdbc.jar"/>
    </driver>
  </provider>
</drivers>