Install using Visual Studio

A guide to install Umbraco CMS using Visual Studio.


Quick Start

This is an abbreviated version of the installation steps. Jump to the Create a new project section for a more thorough guide.
  • Open Visual Studio.
  • Go to File > New > Project, search for Umbraco.
  • Choose Umbraco Project (Umbraco HQ) then click Next.
  • Choose or specify the parameters, leave the default or leave them all empty.
  • Click Create.
  • Use CTRL+F5 to run the project and start the Umbraco installer.

Video Tutorial

How to install Umbraco using NuGet and Visual Studio

Create a new Umbraco project

To install Umbraco we first need to install Umbraco's dotnet new templates.
For more information check the first 2 steps of Install Umbraco with .NET CLI.

Create the Visual Studio project

Go to File > New > Project and search for Umbraco in the Search for templates field.
The Create a new project dialog in Visual Studio.
Once you select Umbraco Project (Umbraco HQ) navigate to the next step by clicking Next.

Configure project

In this step, you will be able to give your project a name specific to the project you are creating.
The Configure your new project dialog in Visual Studio.
Refrain from changing the Solution name, as this will cause a namespace conflict with the CMS itself.

Additional information

In the next step, you are able to specify some additional parameters like the Target framework. The rest are optional.
The Additional information dialog in Visual Studio.
You can then click the Create button and your Umbraco Project will be ready for you.
Overview of files in the project solution

Running the site

You can now run the site through Visual Studio using F5 or the Debug button.
Follow the installation wizard and after a few steps, you will get a message saying the installation was a success.

Next steps

You are now ready to start building your Umbraco project. Have a look below for different resources on the next steps.