Proxy Configuration
If you use a proxy server to protect the clients in your internal network, you may need to configure YouTrack to make HTTP connections with other applications through the proxy server. The following integrations send and receive information over HTTP and must be routed through your proxy server:
You may also need to set up communication through the proxy server when you use an authentication module that connects to a third party service.
The mailbox integration and import from Jira are not blocked by the proxy server.
Proxy-related System Properties
Use the following system properties to let YouTrack connect through a proxy server:
Property | Description |
---|---|
http.proxyHost | The host name of your proxy server. |
http.proxyPort | The port number that the proxy server listens to. |
https.proxyHost | The host name of your secure proxy server. |
https.proxyPort | The port number that the secure proxy server listens to. |
http.nonProxyHosts | A list of hosts that YouTrack accesses directly, bypassing the proxy server.
|
To learn how to set these properties in YouTrack, see Configure JVM Options
Troubleshooting
If you are using a proxy server and experience problems with YouTrack, see if any of the following conditions apply.
Condition | You are unable to connect YouTrack to an external service. For example:
| |
Cause | Solution | |
The external service is unavailable. | Verify that the external service is running. | |
The connection is blocked by a firewall. | Open the ports in the firewall that are used by YouTrack and the connected service. | |
The connection to the external service is blocked by the proxy server. | Set the system properties for your server that let YouTrack connect to other services through the proxy server. Use these properties to specify the hostname and port number of your proxy server. | |
You are trying to connect over the wrong port. | Check the system properties for your YouTrack server and verify that you have set the port parameter correctly. |