Hosting node.js applications in IIS on Windows
Pull request Compare This branch is 98 commits behind tjanczuk:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Hosting node.js applications in IIS on Windows

Why would I want to do it?


Who uses iisnode?

windows azure - benefits
windows azure - get started with node.js

Prerequisites for using

Installing for IIS 7.x/8.x

  • Install iisnode for IIS 7.x/8.x: x86 or x64 - choose bitness matching your system
  • To set up samples, from the administrative command prompt call %programfiles%\iisnode\setupsamples.bat
  • Go to http://localhost/node

Installing for IIS Express/WebMatrix

  • Install WebMatrix using the Web Platform Installer
  • Open WebMatrix, choose “Site from folder”, enter %localappdata%\iisnode\www, start the site, and play with the iisnode samples, or
  • Use node.js templates to get started quickly with an Express application or a skeleton Hello World


the basics
the basics (Pусский перевод)
[NEW: websockets] (
using with express framework
using with URL rewrite module
using with WebMatrix and IIS Express
site templates for WebMatrix
using with mongodb
diagnosing problems with ETW traces
using with MVC
portuguese: node.js no windows: instalando o iisnode
integrated debugging
pub/sub server using faye
appharbor uses iisnode

Prerequisites for building


Build commands should be issued from the build environment set up with "%programfiles(x86)\Microsoft Visual Studio 11.0\Common7\Tools\VsDevCmd.bat", assuming default installation location of Visual Studio 2012 on x64 platform.

For x86 build:

msbuild /p:Platform=Win32 src\iisnode\iisnode.sln

For x64 build:

msbuild /p:Platform=x64 src\iisnode\iisnode.sln

Installing after build

  • For IIS 7.x/8.0: build\debug\{x64|x86}\iisnode-full.msi
  • For IIS Express 7.x: build\debug\x86\iisnode-express.msi

Running tests

  • Install for IIS 7.x/8.x (see previous sections)
  • test\functional\test.bat
  • note that for the WebSocket tests to pass you must be running in IIS 8.x on Windows 8 or Windows Server 2012

Resources & documentation