Suave IIS

Set of helper functions for smooth running Suave.io web server on Internet Information Services (IIS) without common issues like problems with routing on sub-apps, etc...

IIS Installation

To host Suave.io web application, you need to install HttpPlatformHandler (IIS addon that allows to use any http serving application). To install it start the Web Platform Installer (either from your start menu or from the right side actions in IIS Manager) and search for it.

Please note: To be able to enable it per-site, open IIS Manager and in the Feature View for the whole server, open Feature Delegation and enable Handlers Mappings as Read/Write.

Web application installation

Please note: Currently only Suave 2.x.x version is supported. If you are running on older Suave, choose Suave.IIS v1.0.0.

Ok, we got IIS ready, now let`s install Nuget package:

Install-Package Suave.IIS

or using Paket

nuget Suave.IIS

To start using IIS helpers in Suave, create own filter functions based on Suave.IIS.Filters & set port to configuration using withPort function.

[<EntryPoint>]
let main argv =

    // use IIS related filter functions
    let path st = Suave.IIS.Filters.path argv st
    let pathScan format = Suave.IIS.Filters.pathScan argv format

    // routes
    let webpart =
    	choose [
        	path "/test" >=> OK "Look ma! Routing on sub-app on localhost"
            path "/" >=> OK "Hello from Suave on IIS"
        ]

    // start service server
    let config = { defaultConfig with bindings=[HttpBinding.create HTTP IPAddress.Any 8083us]; } |> Suave.IIS.Configuration.withPort argv
    startWebServer config webpart
    0

The last thing we need for proper run on IIS is web.config

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <remove name="httpplatformhandler" />
      <add name="httpplatformhandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified"/>
    </handlers>
    <httpPlatform
                  forwardWindowsAuthToken="true"
                  stdoutLogEnabled="true"
                  stdoutLogFile="myiiswebname.log"
                  startupTimeLimit="20"
                  processPath="C:\inetpub\wwwroot\myiiswebname\myiiswebname.exe"
                  arguments="%HTTP_PLATFORM_PORT% &quot;myiiswebname&quot;"/>
                  <!-- if running on http://localhost/myiiswebname -->
  </system.webServer>
</configuration>

IIS Application

Now create new web application on IIS:

Copy all your build files into C:\inetpub\wwwroot\myiiswebnamemyiiswebname and navigate to http://localhost/myiiswebname. You should see your web application output now.

IIS Site

If you need to run Suave application as Site (on default port 80 or any other port), just omit second parameter in arguments attribute of httpPlatformHandler section in web.config file:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <remove name="httpplatformhandler" />
      <add name="httpplatformhandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified"/>
    </handlers>
    <httpPlatform
                  forwardWindowsAuthToken="true"
                  stdoutLogEnabled="true"
                  stdoutLogFile="myiiswebname.log"
                  startupTimeLimit="20"
                  processPath="C:\inetpub\wwwroot\myiiswebname\myiiswebname.exe"
                  arguments="%HTTP_PLATFORM_PORT%"/>
                  <!-- now running on http://localhost/ -->
  </system.webServer>
</configuration>

Good to know

1. Maybe you didn`t notice, but using this library, you can still run Suave localy (from Visual Studio hitting F5 or FAKE script) - it there are no command line arguments, default setup is used, so you don`t need to change anything. Just use withPort and create custom filter functions based on Suave.IIS.Configuration.
2. Only few (two, actually :)) filter functions are wrapped in Suave.IIS.Filters. If you need more of them, please feel free to send PR.