JAVA Option '-Dhttp.nonProxyHosts' Does Not Work on Windows OS

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the server and data center platforms.


When Bitbucket Server is running on a Windows OS, if there is more than one host that needs to bypass the outgoing proxy and you have configured Bitbucket Server to use an outbound proxy with the -Dhttp.nonProxyHosts JVM argument, connections to those sites are not bypassing the proxy and the connection between the application running on those servers and Bitbucket Server is failing.


  • Bitbucket Server running on Windows OS only


The error messages in the logs will vary based on what application you are connecting to.  Removing the -Dhttp.nonProxyHosts setting from the Java arguments allows for Bitbucket Server to communicate with the servers correctly (but causes features like manage add-ons to loose connection to the Marketplace.


The -Dhttp.nonProxyHosts setting for Java is defined incorrectly.


Change the






(Note that the entire list of exceptions is enclosed in the " characters and the | (or) is not escaped with the \ character

To change this setting for Bitbucket Server Running as a process, .

  1. Stop Bitbucket Server
  2. Edit the <Bitbucket Server_Install>\bin\setenv.bat file
  3. Modify the -Dhttp.nonProxyHosts setting
  4. Save the file
  5. Start Bitbucket Server

To change this setting for Bitbucket Server running as a service:

  1. Stop Bitbucket Server Service
  2. At a CMD prompt, change to the <Bitbucket Server_Install>/bin directory
  3. Run tomcat8w.exe //ES//ServiceName (Default ServiceName is AtlassianBitbucket Server)
  4. Click on the Java Tab
  5. Edit the -Dhttp.nonProxyHosts setting
  6. Save
  7. Start the Bitbucket Server Service

This KB does not apply to Bitbucket Server running on Linux OS's.

Last modified on Sep 6, 2022

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.