Wednesday, 10 December 2014

Building Hosting vNext app on Macbook

Note: This post is outdated and not applied to current version of DNX version. 

In previous post we have learned how to start using the new 5 hosting environment named “K” without using IIS. In this article we’ll learn how to start developing web application on Macbook. As Microsoft announced the OSS of .Net technologies mean one should be able to contribute/create/host apps across platform including Linux, Max and Windows.


The overview of developing and deploying cross platform of web app really exciting thing coming with vNext. One can develop and deploy on any platform they want. I tried to create a picture representing Idea of cross platform develop/deploy.
In above picture the interesting part is Azure gives you an opportunity to create Linux based Virtual Machine. And visual studio enables the deployment and hosting your Web app directly from new Visual Studio 2015. Isn’t it interesting?

Get started

Let start with instructions of how to create/run on a Mac machine. Though all the steps are already specified on github page but to give you more clearer picture of steps with screenshot would definitely help one to step ahead having hands on.
To install KVM (Kruntime** Version Manager) and the correct version of Mono on OS X using Homebrew follow the following steps:
**Note: Kruntime is code that bootstraps and runs an ASP.NET vNext application. This includes things like the compilation system, SDK tools, and the native CLR hosts.
Step 1 -
Install Homebrew if it is not already installed.
Run following command on terminal to install Brew via terminal:
ruby -e "$(curl -fsSL"
Here you need to press Return key. You’ll see following output:
Here you need to insert the password of user you logged-in with.(Make sure user have Administrative rights). Also the cursor will not show you anything when you type password so just type and press Return key and the homebrew will be installed on your machine.
Step 2:
Run command brew tap aspnet/k to tap the ASP.NET vNext related git repositories. If you had already tapped the repo for previous releases, run brew untap aspnet/k to delete the old commands and tap again to get the updated brew scripts.
Step 3:
Run command brew install kvm to install KVM. This also automatically install the latest KRE package from feed.
Step 4:
Run command source on your terminal if your terminal cannot understand kvm.
Step 5:
Run command kvm upgrade. This will install the latest version of Kruntime. Now you’re ready with your Kruntime to host and run vNext apps. Now to start with creating applications you would need an Editor. In this tutorial I’m going to use the Sublime Text 3. Download and install if it’s not already install on your macbook.
Step 6: Setting up and C# plugin for Sublime
Omnisharp have developed many plugins for several famous editors for various platforms. So in order to setup an development environment I have to install the Omnisharp plugin for Sublime. Follow the instructions to make the sublime and C# development ready with similar experience as we have in Visual studio.
Step 7: Getting a solution ready in Sublime text editor.
If you want to start with creating a fresh .Net solution then follow the blogs post here. The post will show you how to create a sublime project and convert it into the vNext project.
In this post I’ll just use the sample solutions which are already there on home branch to save some time for me and you. Install Github for OSx if it’s not already installed. Now clone the home branch from the terminal by running the following command:
Open the project Hello Mvc in the Sublime to check if your color scheme, Language and Intellisense settings are done correctly.
Step 8: Building and Restoring the nuget packages of downloaded samples
Run kpm restore command from terminal. This will restore the nuget packages required to build the project. Make sure you navigate to the directory where the project resides before running the command.
Now your first sample web is ready to host and run on Mac.
Step 9: Hosting and running sample web
Run command k kestrel. This command will build and host the web app on mac. The default port where the application will be running is http://localhost:5004. This is configuration from project.config file. I’ll be writing another post about the new vNext project structure and configurations.
If you see any build errors in code you can open the web application in Sublime editor and fix the build errors if there are compilation errors. To build the from web first change the setting in the Project menu item. Change the Build System to
Fix the compilation errors and build the project using command + B.
That’s all. Happy coding!!!
If you have any questions/doubts or feedback about the article feel free to drop comments below.

1 comment:

  1. Wow, really very nice information for me. Thank you very much. Here I found some information about the Background of next app on MacBook. Learn a lot here. I have recently hosted my site from If I needed than used your technique….