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:
- Start creating a new connection
-
Click on the plus (
) button and select Proxy
-
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