Skip to content
This repository

Hosting node.js applications in IIS on Windows

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 src
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore tuning perf test params to achieve valid results November 30, 2011
Octocat-spinner-32 LICENSE.txt update license November 03, 2011
Octocat-spinner-32 README.md
README.md

Hosting node.js applications in IIS on Windows

Why would I want to do it?

Benefits

Who uses iisnode?

windows azure - benefits
windows azure - get started with node.js
appharbor.com
discountasp.net
arvixe.com

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

Howtos

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

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:

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

For x64 build:

set VisualStudioVersion=11.0
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

Releases
Wiki
Blog

Something went wrong with that request. Please try again.