Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 94 lines (68 sloc) 4.913 kb
f31f5be @tjanczuk Edited README.md via GitHub
tjanczuk authored
1 Hosting node.js applications in IIS on Windows
2 ===
3
8b49968 @tjanczuk Update with link to release notes
tjanczuk authored
4 **Why would I want to do it?**
5
6 [Benefits](https://github.com/tjanczuk/iisnode/wiki)
7
96fb80f @tjanczuk Update README.md
tjanczuk authored
8 **Who uses iisnode?**
9
10 [windows azure - benefits](http://blogs.msdn.com/b/hanuk/archive/2012/05/05/top-benefits-of-running-node-js-on-windows-azure.aspx)
11 [windows azure - get started with node.js](https://www.windowsazure.com/en-us/develop/nodejs/)
bb74994 @tjanczuk Update master
tjanczuk authored
12 [appharbor.com](http://blog.appharbor.com/2012/01/19/announcing-node-js-support)
f4f196c @tjanczuk Update master
tjanczuk authored
13 [discountasp.net](http://discountasp.net/press/2012_06_12_free-webmatrix-v2-rc-hosting-with-nodejs.aspx)
bb74994 @tjanczuk Update master
tjanczuk authored
14 [arvixe.com](http://arvixe.com)
a38bace @tjanczuk Update README.md
tjanczuk authored
15 [smarterasp.net](http://www.smarterasp.net/)
3280ab6 @tjanczuk Update README.md
tjanczuk authored
16 [gearhost.com](http://gearhost.com/)
96fb80f @tjanczuk Update README.md
tjanczuk authored
17
f0d80b7 @tjanczuk readme: refactor prerequisities
tjanczuk authored
18 **Prerequisites for using**
f31f5be @tjanczuk Edited README.md via GitHub
tjanczuk authored
19
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
20 - Windows Vista, Windows 7, Windows 8, Windows Server 2008, or Windows Server 2012
fc1ca94 @exclsr Update README.md to include ASP.NET prereq
exclsr authored
21 - IIS 7.x with IIS Management Tools and ASP.NET
1178707 @tjanczuk Update README.md
tjanczuk authored
22 - WebSocket functionality requires IIS 8.x on Windows 8 or Windows Server 2012
f0d80b7 @tjanczuk readme: refactor prerequisities
tjanczuk authored
23 - [URL rewrite module for IIS](http://www.iis.net/download/URLRewrite)
4a86f39 @tjanczuk Update readme with stable installer links
tjanczuk authored
24 - [Latest node.js build for Windows](http://go.microsoft.com/?linkid=9784334)
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
25 - Visual C++ 2012 Redistributable Package for [x86](http://www.microsoft.com/en-us/download/details.aspx?id=30679) or [x64](http://www.microsoft.com/en-us/download/details.aspx?id=30679) (on x64 systems you need to install both x86 and x64 if you intend to use IIS Express/WebMatrix)
f31f5be @tjanczuk Edited README.md via GitHub
tjanczuk authored
26
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
27 **Installing for IIS 7.x/8.x**
f31f5be @tjanczuk Edited README.md via GitHub
tjanczuk authored
28
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
29 - Install iisnode for IIS 7.x/8.x: [x86](http://go.microsoft.com/?linkid=9784330) or [x64](http://go.microsoft.com/?linkid=9784331) - choose bitness matching your system
35f757a @tjanczuk update readme for 0.1.5
tjanczuk authored
30 - To set up samples, from the administrative command prompt call `%programfiles%\iisnode\setupsamples.bat`
31 - Go to `http://localhost/node`
f31f5be @tjanczuk Edited README.md via GitHub
tjanczuk authored
32
581178e @tjanczuk add iisexpress installation instructions
tjanczuk authored
33 **Installing for IIS Express/WebMatrix**
34
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
35 - [Install WebMatrix using the Web Platform Installer](http://www.microsoft.com/web/webmatrix/)
35f757a @tjanczuk update readme for 0.1.5
tjanczuk authored
36 - Open WebMatrix, choose “Site from folder”, enter %localappdata%\iisnode\www, start the site, and play with the iisnode samples, or
37 - Use node.js templates to get started quickly with an Express application or a skeleton Hello World
f31f5be @tjanczuk Edited README.md via GitHub
tjanczuk authored
38
0bdb4f0 @tjanczuk adding howtos to readme
tjanczuk authored
39 **Howtos**
40
41 [the basics](http://tomasz.janczuk.org/2011/08/hosting-nodejs-applications-in-iis-on.html)
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
42 [the basics (Pусский перевод)](http://softdroid.net/hosting-nodejs-applications-ru)
1178707 @tjanczuk Update README.md
tjanczuk authored
43 [**NEW: websockets**] (http://tomasz.janczuk.org/2012/11/how-to-use-websockets-with-nodejs-apps.html)
0bdb4f0 @tjanczuk adding howtos to readme
tjanczuk authored
44 [using with express framework](http://tomasz.janczuk.org/2011/08/hosting-express-nodejs-applications-in.html)
45 [using with URL rewrite module](http://tomasz.janczuk.org/2011/08/using-url-rewriting-with-nodejs.html)
46 [using with WebMatrix and IIS Express](http://tomasz.janczuk.org/2011/08/developing-nodejs-applications-in.html)
0a5c2c4 @tjanczuk update readme for msi
tjanczuk authored
47 [site templates for WebMatrix](https://github.com/SteveSanderson/Node.js-Site-Templates-for-WebMatrix)
0bdb4f0 @tjanczuk adding howtos to readme
tjanczuk authored
48 [using with mongodb](http://www.amazedsaint.com/2011/09/creating-10-minute-todo-listing-app-on.html)
08bcaa7 @tjanczuk adding ETW howto to readme
tjanczuk authored
49 [diagnosing problems with ETW traces](http://tomasz.janczuk.org/2011/09/using-event-tracing-for-windows-to.html)
5b82aac @tjanczuk adding MVC howto
tjanczuk authored
50 [using with MVC](http://weblogs.asp.net/jgalloway/archive/2011/10/26/using-node-js-in-an-asp-net-mvc-application-with-iisnode.aspx)
53c6608 @tjanczuk add integrated debugging howto
tjanczuk authored
51 [portuguese: node.js no windows: instalando o iisnode](http://vivina.com.br/nodejs-windows-parte-2)
52 [integrated debugging](http://tomasz.janczuk.org/2011/11/debug-nodejs-applications-on-windows.html)
8103d34 @tjanczuk adding link to pub/sub sample from @cibrax
tjanczuk authored
53 [pub/sub server using faye](http://weblogs.asp.net/cibrax/archive/2011/12/12/transform-your-iis-into-a-real-time-pub-sub-engine-with-faye-node.aspx)
db4b9d8 @tjanczuk Update README.md
tjanczuk authored
54 [appharbor uses iisnode](http://blog.appharbor.com/2012/01/19/announcing-node-js-support)
0bdb4f0 @tjanczuk adding howtos to readme
tjanczuk authored
55
f0d80b7 @tjanczuk readme: refactor prerequisities
tjanczuk authored
56 **Prerequisites for building**
57
58 - All prerequisities for using
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
59 - [Visual Studio Express 2012 for Windows Desktop](http://www.microsoft.com/visualstudio/eng/downloads)
60 - [WIX Toolset v3.6](http://wix.codeplex.com/releases/view/93929)
61 - [Windows SDK for Windows 8](http://msdn.microsoft.com/en-us/windows/desktop/hh852363)
f0d80b7 @tjanczuk readme: refactor prerequisities
tjanczuk authored
62
0a5c2c4 @tjanczuk update readme for msi
tjanczuk authored
63 **Building**
64
eafa808 fix #204: enable Windows 8/Windows Server 2012/IIS 8.0 builds
Tomasz Janczuk authored
65 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.
66
67 For x86 build:
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
68
69 ```
70 msbuild /p:Platform=Win32 src\iisnode\iisnode.sln
71 ```
72
eafa808 fix #204: enable Windows 8/Windows Server 2012/IIS 8.0 builds
Tomasz Janczuk authored
73 For x64 build:
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
74
75 ```
76 msbuild /p:Platform=x64 src\iisnode\iisnode.sln
77 ```
0a5c2c4 @tjanczuk update readme for msi
tjanczuk authored
78
35f757a @tjanczuk update readme for 0.1.5
tjanczuk authored
79 **Installing after build**
0a5c2c4 @tjanczuk update readme for msi
tjanczuk authored
80
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
81 - For IIS 7.x/8.0: `build\debug\{x64|x86}\iisnode-full.msi`
35f757a @tjanczuk update readme for 0.1.5
tjanczuk authored
82 - For IIS Express 7.x: `build\debug\x86\iisnode-express.msi`
0a5c2c4 @tjanczuk update readme for msi
tjanczuk authored
83
84 **Running tests**
85
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
86 - Install for IIS 7.x/8.x (see previous sections)
0a5c2c4 @tjanczuk update readme for msi
tjanczuk authored
87 - `test\functional\test.bat`
b77b5ab update readme with VS 2012/Win8 build platform migration
Tomasz Janczuk authored
88 - note that for the WebSocket tests to pass you must be running in IIS 8.x on Windows 8 or Windows Server 2012
0a5c2c4 @tjanczuk update readme for msi
tjanczuk authored
89
f31f5be @tjanczuk Edited README.md via GitHub
tjanczuk authored
90 **Resources & documentation**
91
8b49968 @tjanczuk Update with link to release notes
tjanczuk authored
92 [Releases](https://github.com/tjanczuk/iisnode/wiki/iisnode-releases)
93 [Wiki](https://github.com/tjanczuk/iisnode/wiki)
94 [Blog](http://tomasz.janczuk.org)
Something went wrong with that request. Please try again.