You're visiting the Confluence Knowledge Base. Visit the Confluence Knowledge Base Home for an overview.

Skip to end of metadata
Go to start of metadata

The content on this page relates to platforms that are not supported for Confluence. Consequently, Atlassian can not guarantee providing any support for the steps described on this page. Please be aware that this material is provided for your information only, and that you use it at your own risk.


To install Confluence with IIS using the Apache jk connector.


(info) If you are using JIRA as well as Confluence, please refer to this page in the JIRA documentation instead.

Step 1. Install IIS

If you are running Windows Server 2003, you will only be able to use IIS 5.1 or 6. If you are using Windows Server 2008, you might like to install IIS 7.


If you are using Windows Server 2003 or XP professional, follow these instructions for installing IIS 6.

After installation is complete you should be able to go to http://localhost/iishelp/iis/misc/default.asp in your browser and see the IIS Getting Started page.


Similar to the previous Windows versions, IIS is not installed by default in Windows Server 2008 so you need to install it manually.

  1. Start your Server Manager.
  2. Click 'Roles'.
  3. In the right hand panel, click "Add Roles".
  4. A new window will pop up. Select the 'Web Server (IIS)' option.
  5. Click 'Next' until you see another set of checkbox options to install the required 'Roles Services' for the web server (IIS).
  6. Scroll down to 'Application Development' and tick the following:
    • CGI
    • ISAPI Extensions
    • ISAPI Filters
  7. Click 'Next'.
  8. And lastly, click 'Install'.

To check that IIS has been installed successfully, you can direct your browser to http://localhost/ and see the IIS 7 logo.

You can learn more about IIS 7 from this website.

Please bear in mind that IIS 7 has a default uploading file size limitation of 30MB, please contact your IIS administrator to tune the setting if it is needed.

Step 2. Install Confluence

Do a normal Confluence installation, after which you should be able to use confluence as usual through the URL http://localhost:8090.

Step 3. Configure Tomcat

Add another connector to your server.xml file, directly after the existing <Connector ... /> tag:

Restart Confluence.
In the logs/catalina.YYYY-MM-DD.log file you should see the Jk is running:

Step 4. Configure the Tomcat Connector

These instructions are based on the Tomcat Connector, IIS Configuration documentation.

  1. Download the isapi_redirect.dll from the apache tomcat download page - click 'browse download area' to search for the file.
  2. Place the isapi_redirect.dll file in a directory c:\ajp_iis (the name of the directory isn't important, but if you use a different one make sure to take account of this in the instructions which follow)
  3. Create a file in the same directory as you put the DLL. You can use this sample file if you have used ajp_iisas the directory name.
    • Note that this sample properties file assumes that the dll is named isapi_redirect.dll. If you want to name your DLL something else, you must edit this file.
  4. Create and files. You can use the sample file and the sample file.
  5. Create an empty file named in c:\ajp_iis.

Step 5. Connect Confluence with IIS

Connect Confluence with IIS, depending on your version of IIS:


Help us improve!

Is this article helpful?
Is it well written?
Is the content complete?


  1. Dylan Beattie has posted of how he got Confluence up and running on IIS6 here:

    1. Not quite. What I did was to get Confluence running alongside IIS on a single server - I was still using Tomcat to host the Confluence engine itself, but this configuration meant I could run IIS and ASP.NET websites on the same server as the Confluence wiki.

  2. when i used the connector from iis to tomcat using the dll and instruction provided in

    the iis is set on port 80 and the tomcat set on 8080

    i faced a problem that the pages in subfolders doesn't apear asexample  the http://localhost/loginconfluence/display/~admin

    and after debuging i found that the the url cann't be redirected to http://localhost:8080/loginconfluence/display/~admin

    so i added in the

    # - IIS



    but still the connector reidirect the /loginconfluence/* and not the /loginconfluence/display/*

    so please tell me what is teh solution?


    1. Hi Mohamed,

      To my understanding, in order for IIS to be able to resolve the remaining host path, the following configuration should take place in the file:


      However, the you may need to check and confirm if the worker.list value in the file is correctly named and ensure that the correct worker is pointing to the correct application server.


  3. Step 3 says to add:

    On 2.8.1 (the version we're currently running) the standard Confluence connector had a redirectPort of 8444 and the added AJP connector a redirectPort of 8443 (as stated above).

    However, with 2.10.2 (which I'm getting ready to test an upgrade to) the standard Confluence connector redirectPort has been changed to 8443. I assume I'm going to need to change one or the other in 2.10.2 so the redirectPorts are different?

    1. Hi Liam,

      You do not need to worry about the "redirectPort" for both the standard Confluence connector and AJP connector for your 2.10.2, unless you are setting up a secured connection for Confluence.

      Hope that helps!


      1. Ah, okay. Thanks Komathi! (smile)

  4. Hi, I have a question about step 3. Before I found this article, I set tomcat to run on port 80.  However, I'd like to use port 80 in IIS as well.  My question is, do I change the original connector port back to 8080 and another another identical connector with port 80 (in addition to 8080)?  Also, the IIS setup instruction refers to jakarta.  What is that in reference to setting up IIS?  Sorry, I am new to this and anything would be helpful.



  5. san

    Hi, do you see any problem in the long-run by running Confluence on IIS.  Like any customizations done to pre-IIS Confluence , future upgrades of Confluence ?



  6. Anonymous

    Has anyone tried to connect confluence with the new connector published on riaforge. It is supposed to connect IIS and Tomcat etc.

  7. Anonymous

    I have the redirector working but it is REALLY slow - around 10-15 second to display each page. Connecting to the tomcat server directly via :8080 is quick.


  8. Anonymous

    I have used the BonCode connector same as above ( I ran several million hits as baseline test, and it was stable with good performance. 

    If you are using tomcat directly as webserver, you can probably turn off IIS.

  9. Anonymous

    The URL to get isapi_redirect.dll has changed.

    The new one is in a tomcat-connectors zip file for your OS in (that's on an Australian mirror).

  10. The sample had debug mode in it causing serious performance issues. You might want to change itto WARN because people might not change the defaults provided.