Hosting node.js applications in IIS on Windows
Pull request Compare This branch is 105 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

  • Windows Vista, Windows 7, Windows 8, Windows Server 2008, or Windows Server 2012
  • IIS 7.x with IIS Management Tools and ASP.NET
  • WebSocket functionality requires IIS 8.x with IIS Management Tools and ASP.NET
  • URL rewrite module for IIS
  • Latest node.js build for Windows
  • Visual C++ 2012 Redistributable Package for x86 or x64 (on x64 systems you need to install both x86 and x64 if you intend to use IIS Express/WebMatrix)

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усский перевод)
websockets - coming up!
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