Installing ASP.NET 5 On Mac OS X

By Daniel Roth, Steve Smith, Rick Anderson

Install ASP.NET 5 with Visual Studio Code

The easiest way to get started building applications with ASP.NET 5 is to install the latest version of Visual Studio Code.

  1. Install Mono for OS X (required by Visual Studio Code).
  2. Install Visual Studio Code
  3. Install ASP.NET 5 for Mac OS X

You are all set up and ready to write your first ASP.NET 5 application on a Mac!

Install ASP.NET 5 from the command-line

You can also install ASP.NET 5 from the command-line. There are a few steps involved, since we’ll need to install and configure the environment in which ASP.NET runs, the .NET Execution Environment (DNX). To install DNX, we need one more tool, the .NET Version Manager (DNVM).

Install the .NET Version Manager (DNVM)

To install DNVM:

  1. Run the following curl command:

    curl -sSL | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/
  2. Run dnvm list to show the DNX versions installed

  3. Run dnvm to get DNVM help

The .NET Version Manager (DNVM) is used to install different versions of the .NET Execution Environment (DNX) on OS X.

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 (see Choosing the Right .NET For You on the Server).

To install DNX for .NET Core:

  1. Use DNVM to install DNX for .NET Core:

    dnvm upgrade -r coreclr

To install DNX for Mono:

  1. Install Mono for OS X. Alternatively you can install Mono via Homebrew.

  2. Use DNVM to install DNX for Mono:

    dnvm upgrade -r mono

By default DNVM will install DNX for Mono if no runtime is specified.


Restoring packages using DNX on Mono may fail with multiple canceled requests. You may be able to work around this issue by setting MONO_THREADS_PER_CPU to a larger number (2000).