Get started with ASP.NET Core MVC and Visual Studio for Mac

By Rick Anderson

This tutorial teaches you the basics of building an ASP.NET Core MVC web app using Visual Studio for Mac.

This tutorial teaches ASP.NET Core MVC web development with controllers and views. If you're new to ASP.NET Core web development, consider the Razor Pages version of this tutorial, which provides an easier starting point.

There are 3 versions of this tutorial:


Visual Studio for Mac

Create a web app

From Visual Studio, select File > New Solution.

macOS New solution

Select .NET Core App > ASP.NET Core > ASP.NET Core Web App (MVC) > Next.

macOS New project dialog

Name the project MvcMovie, and then select Create.

macOS New project dialog

Launch the app

In Visual Studio, select Run > Start Without Debugging to launch the app. Visual Studio starts Kestrel, launches a browser, and navigates to http://localhost:port, where port is a randomly chosen port number.

Browser with new project

  • The address bar shows localhost:port# and not something like That's because localhost is the standard hostname for your local computer. When Visual Studio creates a web project, a random port is used for the web server. When you run the app, you'll see a different port number.
  • You can launch the app in debug or non-debug mode from the Run menu.

The default template gives you Home, About and Contact links. The browser image above doesn't show these links. Depending on the size of your browser, you might need to click the navigation icon to show them.

Browser with New project

In the next part of this tutorial, you learn about MVC and start writing some code.