Skip to content

Proxy configuration with system files

Overview

If you're behind a firewall and can't use the UI to configure proxy, you can configure proxy access using system properties, environment variables, or an in-app configuration file:

  • with system properties in the dbeaver.ini file
  • with a global environment variable
  • with an in-app configuration file

Configure proxy

Using system properties

Edit your dbeaver.ini file and add the following lines at the end:

-Dorg.eclipse.net.core.enableProxyService=false
-Dhttps.proxyHost=your-proxy-server-host-name
-Dhttps.proxyPort=your-proxy-server-port-number

Tip

For more details on finding dbeaver.ini, see Configuration files.

Using environment variable

Set the JAVA_TOOL_OPTIONS environment variable:

-Dorg.eclipse.net.core.enableProxyService=false
-Dhttps.proxyHost=your-proxy-server-host-name
-Dhttps.proxyPort=your-proxy-server-port-number

Warning

This affects all Java applications, not just DBeaver.

Using in-app configuration file

The proxy configuration file depends on your installation type.

  • Writable location:

    If DBeaver is installed in a writable location (like C:\Users\USER\AppData\Local\DBeaver\), use:

    C:\Users\USER\AppData\Local\DBeaverTeam\configuration\.settings\org.eclipse.core.net.prefs

  • Read-only location:

    If DBeaver is installed in a read-only location (like C:\Program Files\DBeaver\), use:

    C:\Users\USER\AppData\Roaming\DBeaverData\install-data\com.dbeaver.team\CLIENT-VERSION\.settings\org.eclipse.core.net.prefs

Paste the following content into that file:

eclipse.preferences.version=1
org.eclipse.core.net.hasMigrated=true
proxyData/HTTPS/hasAuth=false
proxyData/HTTPS/host=your-proxy-server-host-name
proxyData/HTTPS/port=your-proxy-server-port-number

Tip

For plain HTTP, replace all proxyData/HTTPS/ prefixes with proxyData/HTTP/.