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. This includes, but is not limited to:

Apps that use the YouTrack Workflow API to exchange and transfer data over HTTP.
Apps that use the YouTrack Import API.

YouTrack's notification services and mailbox integrations are not capable of routing traffic through a proxy server. All SMTP/IMAP/POP3 connections should either be unobstructed or transparent to YouTrack.

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. Delimit multiple hosts with a vertical bar. Use the asterisk as a wildcard character to specify a pattern. The list of non-proxy hosts can be used with both HTTP and HTTPS protocols. If this property is not set, all traffic is routed through 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:

You try to set up a VCS integration and get a bad_request error.
You try to set up an authentication module and get the exception: Authentication failed. java.net.ConnectException: Connection refused.

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.

Last modified: 22 March 2024

Proxy Configuration

Proxy-related System Properties

Troubleshooting