Hosting node.js applications in IIS on Windows

Why would I want to do it?

Benefits

Prerequisites for using

• Windows Vista, Windows 7, or Windows Server 2008
• IIS 7.x with IIS Management Tools
• URL rewrite module for IIS
• Latest node.js build for Windows
• Visual C++ 2010 Redistributable Package for x86 or x64 (skip this if you install Visual Studio; on x64 systems you need to install both x86 and x64 if you intend to use IIS Express/WebMatrix)

Installing for IIS 7.x

• Install iisnode for IIS 7.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
• Install iisnode for IIS Express 7.x
• Install node.js templates for WebMatrix
• 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

Howtos

the basics
the basics (Pусский перевод - Russian translation)
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

• All prerequisities for using
• Visual Studio C++ Express
• WIX Toolset v3.5
• IIS 7 header files from Windows SDK

Building

• For 32 bit Windows: msbuild /p:Platform=Win32 src\iisnode\iisnode.sln
• For 64 bit Windows: msbuild /p:Platform=x64 src\iisnode\iisnode.sln

Installing after build

• For IIS 7.x: build\debug\%PROCESSOR_ARCHITECTURE%\iisnode-full.msi
• For IIS Express 7.x: build\debug\x86\iisnode-express.msi

Running tests

• Install for IIS 7.x (see previous sections)
• test\functional\test.bat

Resources & documentation

Releases
Wiki
Blog