Install using Visual Studio
A guide to install Umbraco CMS using Visual Studio.
Prerequisites
Install the newest Umbraco dotnet templates.
In Visual Studio 2022, the .NET CLI templates are enabled to appear, by default. For information on how to enable .NET CLI templates in Visual Studio 2019, see the .NET CLI Templates in Visual Studio article.
Check the Requirements to ensure you have everything you need to start your Umbraco project.
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
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.
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2F65787334-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8h0xdoteqcFVV1pGZgk0%252Fuploads%252Fgit-blob-a75a86267b169bce9e8999e311f41ce9e6d7edd4%252Fcreate-project.png%3Falt%3Dmedia%26token%3D163a96ab-6d90-42b4-a0df-2d4fb12ce5af&width=768&dpr=4&quality=100&sign=94c7133e&sv=1)
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.
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2F65787334-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8h0xdoteqcFVV1pGZgk0%252Fuploads%252Fgit-blob-b5882efaab74a56cd64d782fe3573f11d8e522e3%252Fconfigure-project.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=743725b1&sv=1)
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.
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2F65787334-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8h0xdoteqcFVV1pGZgk0%252Fuploads%252Fgit-blob-b1005b76548a43705dd0a43defce74837a06c6ce%252FUmbraco10_install.png%3Falt%3Dmedia%26token%3D80c587b2-96b0-4160-8d81-3861d8445ceb&width=768&dpr=4&quality=100&sign=3e20be88&sv=1)
You can then click the Create button and your Umbraco Project will be ready for you.
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2F65787334-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8h0xdoteqcFVV1pGZgk0%252Fuploads%252Fgit-blob-9059c79ec2f55ad993b4aefa2db42fc5b370449e%252Fready-solution.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=6abaa4d5&sv=1)
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.
Last updated