Skip to content

Proxy configuration

Overview

The desktop client of Team Edition connects to a remote Team Edition server over HTTP(S). If you're behind a firewall or need to route traffic through a proxy, you’ll need to configure an HTTP(S) proxy.

You can configure the proxy:

  • 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 Team Edition.

Using in-app configuration file

The proxy configuration file depends on your installation type.

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

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

If Team Edition is installed in a read-only location (like C:\Program Files\DBeaverTeam\), 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/.

Troubleshooting

Your proxy server must support WebSocket connections. If you're using Squid, add the following to your config:

http_upgrade_request_protocols allow all

Tip

For more details on how to enable it in the Squid proxy, see the official documentation.