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 and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible


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 Oct 25, 2023

Was this helpful?

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