Table of contents

• Configure proxy
  • Using system properties
  • Using environment variable
  • Using in-app configuration file

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/.