# Install using Visual Studio Code

Follow these steps to set up an Umbraco project with Visual Studio Code. The benefit of using Visual Studio Code is that it is super quick to get up and running.

## Installing and setting up Visual Studio Code

1. Go to <https://code.visualstudio.com/> and download Visual Studio Code for free.
2. Once installed, launch Visual Studio Code.
3. Click the extensions menu at the bottom on the left side. Then search for **C#** and install it.

   ![Visual Studio Code install extension](/files/T9tED7ZkUvCFUWPZJ4aP)

## Creating your Umbraco project

Follow the [Templates Guide](/umbraco-cms/13.latest/fundamentals/setup/install/install-umbraco-with-templates.md) to create your project folder.

## Configure Visual Studio Code to run the Umbraco project

Open your project folder in Visual Studio Code, your project will look something like this:

![Fresh Umbraco installation](/files/Fe4UVL2vxI0LUbZKhOc8)

Now we need to tell Visual Studio Code how to run your project.

Open the command palette, you can use the shortcut `Ctrl+Shift+P`, and type in `Tasks: Configure` and select the `Tasks: Configure Task` option:

![Configure task option](/files/h0kMprlYYbXZLrx82bTL)

Select "Create task.json from template"

![Create task from template](/files/8HXsGLGETYOswmXPFkfw)

Now select ".NET Core" as your template.

![Create .NET Core Template](/files/FwNWg3Tjujxb52XAeo1e)

Visual Studio Code creates a folder called `.vscode` that contains a file called `tasks.json`. The `tasks.json` file tells Visual Studio Code how to build your project.

Now that we've told Visual Studio Code how to build your project, we need to tell it how to launch it. Visual Studio Code can do this for you. First, select the little play button in the left side menu, and then select the "create a launch.json file" link.

![Creating launch.json file](/files/ICbr0pDJxO2HVhcldSbM)

This will prompt a menu to appear, select **.NET 5+ and .NET Core**:

<figure><img src="/files/C10iscBDiv0RfuQkxOSM" alt=""><figcaption><p>Prompt Menu</p></figcaption></figure>

{% hint style="info" %}
If **.NET 5+ and .NET Core** is missing in the drop-down menu:

1. Press **Ctrl + Shift + P** (on Windows/Linux) or **Cmd + Shift + P** (on macOS) to open the Command Palette.
2. Search for the command `.NET: Generate Assets for Build and Debug`.\
   This command will generate the necessary assets for building and debugging your .NET application.
   {% endhint %}

Now you'll see a green play button appear with a dropdown where ".NET Core Launch (web)" is selected.

<figure><img src="/files/4I8gUrLyy7vgRvfTNhYP" alt=""><figcaption><p>Green Play button options</p></figcaption></figure>

If you navigate to the Files section, a new `launch.json` file is created in the `.vscode` folder. When you press F5, the `launch.json` file tells Visual Studio Code to build your project, run it, and then open a browser .

<figure><img src="/files/M5v8OQaZTobRhg0p6FDM" alt=""><figcaption></figcaption></figure>

With that, you're ready to run the project! Press F5, or click the little green play button in the **Run and Debug** section to run your brand new Umbraco site locally.

## Umbraco Web Installer

This section covers the installation and configuration of Umbraco inside your web browser when you run Umbraco for the first time.

You will see the install screen where you will need to fill in some data before Umbraco can be installed.

![Web Installer - Lets Get Started](/files/LPzm9fnvyF0owhplKK2J)

When the installer is done, you will be logged into the backoffice.

<figure><img src="/files/pJEFOVk5qaNMfnw7OP7n" alt=""><figcaption></figcaption></figure>

Congratulations, you have installed an Umbraco site!

{% hint style="info" %}
You can log into your Umbraco site by entering the following into your browser: `http://yoursite.com/umbraco/`.
{% endhint %}


---

# 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/13.latest/fundamentals/setup/install/install-umbraco-with-vs-code.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.
