How to create a Pyramid website in IIS after an install.

If you have decided to use the IIS option after the Pyramid installation, you can add the site manually. 

First, you need to install the following IIS modules :

To install "IIS URL Rewrite Module 2" and "Microsoft Application Request Routing 3.0" please download and install them using the links below:
Note, that before installing them, you'll need to close IIS first.

Once the above two IIS add-on's have been downloaded, run the installer and follow the on-screen prompts.

Once the above two models have been installed, activate the proxy as shown below:
Open IIS >Double click on the server name(1)>Double Click on "Application Request Routing Cache"(2)
Click on "Server Proxy Settings..."(3)

Then Tick the box "Enable proxy"(4)>Click on Apply(5)

Secondly, create a new website and point it to the following location:

C:\program files\pyramid 2018\repository\iis


For the site name call it "pyramid2018", for the Physical path point it to C:\program files\pyramid 2018\repository\iis, for the hostname it can be anything but please note that you must add this to your DNS or local host file.


Then double click on the newly created site >URL Rewite. Double click on the first rule and make sure the Rewrite URL is: http://localhost:8181/{R:1}

Once the above steps have been done, please do an IISRESET and then try to access Pyramid 2018 again using the newly created IIS website.

NOTE: Ensure that the relevant ports are open on the firewall: 80 for HTTP and 443 for HTTPS.

3 replies

    • BI Project
    • Alister_Hill
    • 5 yrs ago
    • Reported - view

    Worked a treat thanks.

    Exported/Imported my certificate from the old BI Office 6 server too, and works with SSL binding.


    • Juan_Pablo_Valdivieso
    • 6 mths ago
    • Reported - view

    Hi, I tried to follow these steps, but I am not sure where and how to configure these points:
    add this to your DNS or local host file.

    Do you have an example of that configuration please.

      • Carey_Doughty
      • 6 mths ago
      • Reported - view


      Hi Juan Pablo,

      Modifying the hosts file on the IIS server ensures that the virtual name (the web address for the Pyramid website on the load balancer) points to the local IP of the server.

      To add an entry to the host file, first open the file located here:


      In the host file of each web server you should create an entry that has the local IP of the webserver and then the virtual name.

      e.g. mypyramidwebsite

      After making the above changes, do an IISRESET and flush the DNS.
      This should be done on each Pyramid webserver that is in the Pyramid  deployment.