Getting started

Prerequisites to run Kudu

• Visual Studio 2012. Note that you need to run it as admin.
• 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).
• Install Node. Node is used as part of the build process for sites.
• Install Mercurial to the default location (we expect it in C:\Program Files (x86)\Mercurial)

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 IISNode
• Pretend to have the 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 node.exe version 0.8.2. Yes, this is kind of painful, and we need to make it easier!
• The Web and WebApplications folders need to be present under \Program Files (x86)\MSBuild\Microsoft\VisualStudio\v10.0. If you don't have them, you may need to copy them from a machine that has VS 2010 installed. This is needed because some of the test apps target these. TODO: we need to make this easier!

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!