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.
- Start creating a new connection.
-
Click on the plus (
) button and select Proxy.
-
After selecting, an SSH tab will appear in the menu at the top.
-
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