Getting started

Prerequisites to run Kudu

• Visual Studio 2012
• IIS >= 7, configured to run ASP.NET 4.0. This can be installed using WebPI.
• Install Git (http://git-scm.com/downloads) to the default location (we expect it in C:\Program Files (x86)\Git\bin).

Note: If you manually install IIS, here is what needs to be enabled:

Additional prerequisites to run the functional tests

• Install the XUnit.net runner for VS 2012, which you install from Tools / Extensions & Updates
• Open your %WINDIR%\System32\inetsrv\config\applicationHost.config and look for <applicationPoolDefaults>. Under <processModel>, make sure you don't have setProfileEnvironment="false". If you do, set it to true.
• Install the URL rewrite module for IIS.
• Install Node.
• Install IISNode
• Pretend to have teh 32 bit version of Node to fool the version detection logic:
• Copy your \Program Files\nodejs folder to \Program Files (x86)\nodejs.
• Under \Program Files (x86)\nodejs, you need to have a folder named 0.8.2, and containing a file named node.exe. it does not matter what this file is, as only its presence is checked!.

Deploying your first application

1. First clone the repository.

    git clone git://github.com/projectkudu/kudu.git
   

2. Open Kudu.sln as Administrator and build it.

3. Set Kudu.Web as the startup project and run!

After running Kudu.Web, you should be able to use the dashboard to manage your application. Below is a walk through on how to create and deploy your first application using git.

Step 1

Create an application.

Step 2

Give it a name.

Step 3

Copy the git url and push.

Step 4

You're live!