Skip to content

Proxy configuration

If you’re behind a corporate firewall or use a restricted network, you may need to configure a proxy to:

  • download 3rd party JDBC drivers
  • check for product updates
  • connect to external databases
  • activate or update a commercial license

Configure a proxy

DBeaver supports two types of proxy settings:

  • Global proxy – applies to all network features in the application
  • Connection proxy – used for database connections

Global proxy

Network access

If your access to license services or other online features is restricted, configure a proxy in Network Connections preferences.

Tip

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.

Active provider

The Active Provider setting controls how proxy settings are applied:

Option Description Default behavior
Direct Connects directly to the internet without using a proxy. Use your system’s normal internet connection.
Manual Lets you enter proxy details manually in the Proxy entries section. Select Manual and enter the proxy settings.
Native Uses the proxy configuration from your operating system or active web browser. Select Native to use OS or browser settings. See how to set browser proxy settings.
Manual proxy configuration

If you choose Manual, you’ll need to fill in the proxy details in the Proxy entries table.

Setting Description Valid values / defaults
Schema The connection protocol type for the proxy. HTTP (80), HTTPS (443), SOCKS (1080)
Host The hostname or IP address of the proxy server. Any valid hostname or IP address
Port The proxy server port number. If left blank, the default for the selected schema is used. 1-65535; defaults: HTTP=80, HTTPS=443, SOCKS=1080
Auth Whether authentication is required for the proxy. Yes, No
User Username for proxy authentication (if Auth is set to Yes). Any valid username string
Password Password for proxy authentication (if Auth is set to Yes). Any valid password string
Proxy bypass Hosts that should be accessed directly without using the proxy. Any valid hostname or IP address

To activate or update a license, DBeaver only needs to access dbeaver.com. You can ask your network administrator to add dbeaver.com to the whitelist.

Tip

You can add multiple bypass entries for hosts that should be reached without using the proxy.

Drivers download

If driver downloads are blocked, configure a proxy in the Drivers preferences.

Navigate to Window -> Preferences -> Connections -> Drivers.

Setting Description
Proxy Host The hostname or IP address of the proxy server used for driver downloads.
Proxy Port The port number of the proxy server (commonly 8080 for HTTP or 1080 for SOCKS).
User The username for proxy authentication (if required).
Password The password for proxy authentication (if required).

Note

These settings apply only to driver downloads. Your main database connection settings must be configured separately.

Drivers are usually downloaded from the maven.org website. You may also ask your network administrator to add maven.org to the list of allowed external domains.

Connection proxy

If your access to external databases is restricted, configure a proxy directly in the connection settings:

  1. Start creating a new connection
  2. Click on the plus () button and select Proxy

  3. The Proxy tab will appear at the top. You can configure it manually or use automatic detection

Automatic proxy configuration

Note

This feature is available in Lite, Enterprise, Ultimate and Team editions only.

Setting Description
Use automatic proxy detection Tries to detect and apply proxy settings automatically, based on system or platform settings.
Use browser proxy settings Uses the proxy settings from your default web browser, if supported.
Use OS settings Uses the proxy settings from your operating system.
Use environment variables Reads proxy configuration from environment variables (e.g., HTTP_PROXY, HTTPS_PROXY).
SOCKS
Setting Description
Host Hostname or IP address of the SOCKS proxy server.
Port SOCKS proxy port number.
User name Username for SOCKS proxy authentication (if required).
Password Password for SOCKS proxy authentication (if required).
Save Password/Passphrase Stores the authentication details securely for future use.
Open global network preferences Opens the global proxy settings page, where you can configure system-wide proxy rules.

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