Skip to content

Proxy configuration

Sometimes DBeaver needs to access external internet resources for tasks such as:

  • 3rd party JDBC drivers download
  • Information about a new DBeaver version
  • Connect to remote databases outside of your corporate network
  • Subscription license activation (commercial version)
  • License information update (commercial version)

If you are behind some corporate firewall which restricts access to external internet resources then it may become a real problem. Sometimes corporate firewalls allow access to external resources using a web browser but restricts this for all other applications.

Configure a proxy for drivers download

You need to ask your network administrator about proxy parameters. Then go to Window -> Preferences -> Connections -> Drivers.

You can enter a proxy host/port and (optionally) user/password here. It will be used for drivers download only. Drivers are usually downloaded from maven.org web site. You may also ask your network admin to add maven.org to the list of allowed external domains.

Configure network for license activation

You need to configure a global proxy server. If you cannot activate your subscription license then you first need to use a trial version to start DBeaver and configure a proxy.

Go to Preferences -> Connections -> Network Connections:

Switch to Manual or Native proxy (native proxy settings will use an active web browser proxy configuration).

Note

in order to activate/update a license DBeaver only needs to access the website dbeaver.com. You may ask your network administrator to add dbeaver.com to the white list.

Configure a proxy for external databases access

You can configure proxy settings for an individual connection.

  1. Start creating a new connection.

  2. Click on the plus () button and select Proxy.

  3. After selecting, an SSH tab will appear in the menu at the top.

  4. Set the Proxy Settings: After selecting Proxy, a Proxy tab will appear in the menu at the top. You may set the proxy settings manually or use the active OS/web browser settings from this tab.

Note

Automatic proxy configuration is available in Lite, Enterprise, and Ultimate editions only.

Configure proxy using system files

If you can't use the UI or need to apply proxy settings globally, you can configure proxy access using system files or environment variables.

See Proxy configuration with system files for details on:

  • editing the dbeaver.ini file
  • using JAVA_TOOL_OPTIONS environment variable
  • configuring the .prefs file for Eclipse-based networking