• Configure a proxy
  • Global proxy
    • Network access
      • Active provider
      • Manual proxy configuration
  • Drivers download
  • Connection proxy
    • Automatic proxy configuration
    • SOCKS
  • Configure proxy using system files

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

DBeaver supports two types of proxy settings:

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

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.

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.

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.

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.

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

   

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

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.

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