# Install using Visual Studio

## Prerequisites

* Install the newest [Umbraco dotnet templates](https://docs.umbraco.com/umbraco-cms/16.latest/fundamentals/setup/install/install-umbraco-with-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](https://devblogs.microsoft.com/dotnet/net-cli-templates-in-visual-studio/) article.
* Check the [Requirements](https://docs.umbraco.com/umbraco-cms/16.latest/fundamentals/setup/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](#create-a-new-umbraco-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

{% embed url="<https://www.youtube.com/watch?ab_channel=UmbracoLearningBase&v=CDeAYGu_-cI>" %}
How to install Umbraco using NuGet and Visual Studio
{% endembed %}

## Create a new Umbraco project

To install Umbraco, follow these steps:

1. Install the latest [.NET SDK](https://dotnet.microsoft.com/download).
2. Run `dotnet new install Umbraco.Templates` to install the project templates.

### 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.](https://1645900983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfgxE4oDrCrIoTxSfjpor%2Fuploads%2Fgit-blob-a75a86267b169bce9e8999e311f41ce9e6d7edd4%2Fcreate-project.png?alt=media)

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.](https://1645900983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfgxE4oDrCrIoTxSfjpor%2Fuploads%2Fgit-blob-0666959592aa748d2e088af0940b8610be3a024f%2FNew_Project.jpg?alt=media)

{% hint style="info" %}
Refrain from changing the Solution name, as this will cause a namespace conflict with the CMS itself.
{% endhint %}

### 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.](https://1645900983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfgxE4oDrCrIoTxSfjpor%2Fuploads%2Fgit-blob-24f1f3326c788e7082c83bfcc7b4ee4a2f717574%2FAdditional_Info_V15.png?alt=media)

You can then click the *Create* button and your Umbraco Project will be ready for you.

![Overview of files in the project solution](https://1645900983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfgxE4oDrCrIoTxSfjpor%2Fuploads%2Fgit-blob-254eb8d89be44d42e123c997fb4fd7483e39cdd9%2FSolution_Explorer.png?alt=media)

### 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.

* [Getting Started with Umbraco](https://docs.umbraco.com/umbraco-cms/16.latest/tutorials/creating-a-basic-website/getting-started)
* [Tutorial: Create a website from scratch](https://docs.umbraco.com/umbraco-cms/16.latest/tutorials/creating-a-basic-website)
* [Find different options for hosting your Umbraco website](https://docs.umbraco.com/umbraco-cms/16.latest/fundamentals/setup/server-setup)
* [Learn about configuration in Umbraco CMS](https://docs.umbraco.com/umbraco-cms/16.latest/reference/configuration)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-cms/16.latest/fundamentals/setup/install/visual-studio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.