How to set up Microsoft IIS as a reverse proxy for Bitbucket Server

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform Notice: Server, Data Center, and Cloud By Request - This article was written for the Atlassian server and data center platforms but may also be useful for Atlassian Cloud customers. If completing instructions in this article would help you, please contact Atlassian Support and mention it.


In the event that an organization wants to set up a simple Microsoft IIS site for the purposes of acting as a reverse proxy for Bitbucket Server, these steps can serve as an example configuration.


  1. Download the following IIS modules if they haven't already been installed/enabled:
  2. Complete installation of the above IIS modules on your IIS server
  3. Create a new site within IIS with the desired name, app pool, physical path and binding
    • The Physical Path shouldn't matter, as we will not be hosting any web content originating from IIS itself.

  4. Within this new site, select the URL Rewrite section
  5. Click Add Rule(s)... in the top right, and select Reverse Proxy
  6. On this new window, input the name/IP of the server that is hosting Bitbucket - along with the port that Bitbucket is listening on. If you are terminating SSL on IIS, be sure to select Enable SSL Offloading
  7. At this point, you should be able to access Bitbucket by navigating to your IIS server at the binding associated with the site created above.

    If you have some issues with Bitbucket UI elements returning the error "400 Bad Request", please make sure that the Application pools related to this application have the "No Managed Code" setting to avoid requests being redirected to .NET framework.

Last modified on Mar 24, 2020

Was this helpful?

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