UPDATE (2016-OCT-10): Everything has changed, for the better. This process is much easier now. I will follow-up soon with a new guide.

For my tests, I sparked up an Ubuntu 14.04 64-bit image in Parallels.

Following the instructions on the Asp.Net site, I was able to get Asp.Net 5 installed on my image.

Here are the steps broken down:

Install the .NET Version Manager (DNVM)

Use the .NET Version Manager (DNVM) to install different versions of the .NET Execution Environment (DNX) on Linux.

Install unzip and curl if you don’t already have them:

sudo apt-get install unzip curl

Download and install DNVM:

curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/dnvm.sh

Once this step is complete you should be able to run dnvm and see some help text.

dnvm will output:

    ___  _  ___   ____  ___
   / _ \/ |/ / | / /  |/  /
  / // /    /| |/ / /|_/ / 
 /____/_/|_/ |___/_/  /_/  

.NET Version Manager - Version 1.0.0-rc2-15545
By Microsoft Open Technologies, Inc.

DNVM can be used to download versions of the .NET Execution Environment and manage which version you are using.
You can control the URL of the stable and unstable channel by setting the DNX_FEED and DNX_UNSTABLE_FEED variables.

Current feed settings:
Default Stable: https://www.nuget.org/api/v2
Default Unstable: https://www.myget.org/F/aspnetvnext/api/v2
Current Stable Override: <none>
Current Unstable Override: <none>

Use dnvm [help|-h|-help|--help]  to display help text.

Install the .NET Execution Environment (DNX)

The .NET Execution Environment (DNX) is used to build and run .NET projects. Use DNVM to install DNX for Mono or .NET Core.

To install DNX for .NET Core:

  • Install the DNX prerequisites:
sudo apt-get install libunwind8 gettext libssl-dev libcurl4-openssl-dev zlib1g libicu-dev uuid-dev
  • Use DNVM to install DNX for .NET Core:
dnvm upgrade -r coreclr

To install DNX for .NET Core:

  • Install Mono

Breaking down the instructions at http://www.mono-project.com/docs/getting-started/install/linux/#debian-ubuntu-and-derivatives:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list

sudo apt-get update

echo "deb http://download.mono-project.com/repo/debian wheezy-apache24-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list

sudo apt-get install mono-devel

sudo apt-get install mono-complete

sudo apt-get install referenceassemblies-pcl

sudo apt-get install ca-certificates-mono
  • Use DNVM to install DNX for Mono:
dnvm upgrade -r mono

Install libuv

Libuv is a an IO library that is used by Kestrel.

To build libuv, run each of the following steps:

sudo apt-get install make automake libtool curl

curl -sSL https://github.com/libuv/libuv/archive/v1.4.2.tar.gz | sudo tar zxfv - -C /usr/local/src

cd /usr/local/src/libuv-1.4.2

sudo sh autogen.sh

sudo ./configure

sudo make

sudo make install

sudo rm -rf /usr/local/src/libuv-1.4.2 && cd ~/

sudo ldconfig

Install Node.js and npm

curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -

sudo apt-get install -y nodejs

sudo npm install -g npm

Install yeoman and the Asp.Net 5 generator

`sudo npm install -g yo bower grunt-cli gulp

`sudo npm install -g generator-aspnet

Install Docker

My suggestion would be to use the official instructions at http://docs.docker.com/engine/installation/ubuntulinux/, however, I followed the posting at https://blog.markrendle.net/fun-with-asp-net-5-linux-docker-part-3/.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9

sudo sh -c "echo deb https://get.docker.com/ubuntu docker main > /etc/apt/sources.list.d/docker.list"

sudo apt-get update

sudo apt-get install lxc-docker

To verify that it is installed:

docker --version

It should return something like this:

Docker version 1.9.1, build a34a1d5

To get around having to use sudo on every Docker command, run the following four commands, replacing ${USER} with your own username:

sudo groupadd docker
sudo gpasswd -a ${USER} docker
sudo service docker restart
newgrp docker

###Create a new Asp.Net web application

yo aspnet

Follow the instructions to create a basic web application.

cd {name of folder (name of web application)}

dnu restore

dnx web

Open a web browser and point it at http://localhost:5000 and you should see a standard template site.

###Deploy a Docker container

Create a Docker container

Inside of the folder that houses your web application’s source code, you will find a Dockerfile file. The generator that I was using, created:

# Base of your container
FROM microsoft/aspnet:latest

# Copy the project into folder and then restore packages
COPY . /app
RUN ["dnu","restore"]

# Open this port in the container
# Start application
ENTRYPOINT ["dnx","-p","project.json", "web"]

Run the Docker container

Swap out {yourapplication} for the actual name of your application

docker build -t {yourapplication} .

docker run -t -d -p 8080:5000 {yourapplication}

Now if you open your web browser and point it to http://localhost:5000 and you should see the same template site that you saw earlier.


Turns out that Docker forwards requests on, but Kestrel (the web server) listens on localhost. I got this information from http://stackoverflow.com/questions/33977474/cannot-run-asp-net-5-from-docker via answers by users @trm5073 and @armen.shimoon.

Find the container’s id:

docker ps

The response will look something like this:

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                    NAMES
a957ec2ee445        helloworldweb       "dnx web --server.url"   15 hours ago        Up 15 hours>5000/tcp   agitated_almeida

Use the Container ID to stop the container:

docker stop a957ec2ee445

Open the Dockerfile and change it to:

FROM microsoft/aspnet

COPY . /project        
WORKDIR /project       
RUN ["dnu", "restore"]

ENTRYPOINT ["dnx", "web", "--server.urls", ""]

Now run the container again:

docker run -t -d -p 8080:5000 {yourapplication}

Point your browser to http://localhost:8080 and tears of disbelief…