Installing IIPImage on IIS7

How To Install IIPImage on Windows 2008/IIS7 – 2008R2/IIS7.5

It is now finally possible to install IIPImage on IIS7 and IIS7.5! Many thanks indeed to Ricardo Valdiviezo for getting this to work and for sending us the following detailed and illustrated tutorial.


  1. First, if it is not already installed, install IIS 7/7.5.
  2. Install the FastCGI extension
  3. Download the IIPImage Windows package and unzip it into a folder (e.g. “C:\IIPServer”)
  4. Create a folder called images into the folder which was created in step 3
  5. Create a new folder called logs into the folder which was created in step 3
  6. Rename the file iipsrv.fcgi to iipsrv.exe
  7. Now you should be able to see the following folders and files into the folder which was created in the step 3:
  8. Folders and files created in previous step

    Configure FastCGI

  9. Open your Internet Information Service Manager and click on the server icon, then open the FastCGI Settings:
  10. IIS Manager - FastCGI configuration
  11. Give permissions to new folders and files
  12. This is a variable based on the authentication scheme selected for the website. For AppPoolIdentity you need assign the following permissions to the various directories you have created and to the dlls and .exe files:


    For dlls and exe files give execute permissions for IIS_IUSRS user:

    Execute Permissions for DLLs and EXEs

    Only read permission is required for your images directory:

    Image Folder Read Permissions

    Write permission must be allowed for the IIS_IUSRS user for logging:

    Log Permissions

    Application Configuration

  13. Add a new Application and configure it.
  14. 10.1 Click on Add Application in the Actions pane.

    10.2 Enter the full path of the file “iipsrv.exe” (e.g. c:\iipServer\iipsrv.exe )

    10.3 Leave Arguments empty.

    10.4 In FastCGI Properties add various FCGI parameters.

    For example:

    - Instance MaxRequest : 200
    - Standard Error Mode: ReturnStdErrIn500
    - Activity TimeOut: 30
    - Idle Timeout: 300
    - Queue Length: 1000

    And so on. You can change these values at any time and tailor them to your needs.

    10.5 Now configure the IIPImage server parameters. For IIS7/7.5, unlike IIS6, there is no fcgiext.ini file, so you will need to enter these parameters as Environment variables individually. See the server documentation for a full list of available parameters.

    Add IIPImage Server parameters

    Site configuration

  15. You need to configure a “Handler Mappings” for the new extension “.fcgi” or any other do you want. This can be configured at Server level, Site level, directory or virtual directory level. In this example we configure it as virtual directory.
  16. Create a Virtual Directory (fcgi-bin)
  17. Create an empty file iipsrv.fgci inside this new directory. (You may name this something else if you wish)
  18. Create a Handler Mapping:
    1. In the Actions pane click Add Module Mapping
    2. In Request path enter *.fcgi
    3. In Module select FastCGIModule
    4. On Executable (optional)” enter the full path of the exe file, e.g. c:\iipServer\iipsrv.exe (This is NOT in fact optional for IIPImage)
    5. Click Request Restrictions then on Access tab, select Execute
    6. Click OK, OK and accept the Warning message that will appear.
  19. Copy the client samples into the website (It can be copied at any location, not necessarily in a virtual directory)
  20. To test with IIPZoom 0.2, adjust the following javascript vars:
//This is the path to your empty file created in step 13
var server = "/fcgi-bin/iipsrv.fcgi";

//This is the full path to your source TIFF image
var image = "/IIPServer/images/flower2T.tif";

Optionally, on IIS 7/7.5 you can configure the “Application Request Routing Cache” in order to improve its performance.