Skip to the content

Umbraco CMS Installation with Visual Studio

Umbraco install procedure
How to install Umbraco on your machine

This is a method to perform multiple repeat installs of Umbraco CMS on your web server or local machine running IIS 8 and Windows. This method allows for a repeat installs that always use the latest Umbraco release.


  • If you are using a Microsoft SQL instance for your data store:
  • create an empty database
  • setup access for a user for that database
  • keep the access details and user credential handy, you will need them later on in the installation
  • Create an empty folder to hold your new website. This is usually done within an existing IIS infrastructure that has a wwwroot folder with websites under it.

Umbraco Installation

Requirements: Visual Studio – community edition or higher.

Start VS

Start Visual Studio and select the file option to create a new project.

Select ASP Net Application. Browse to the folder you have created during the preparation step.

Select it and enter a name for your project. 

Visual Studio - Create Project

Now select an Empty project template. Tick none of the options.

Once the template is loaded and the new project is created. Select the NuGet Package Manager from the Tools menu as shown below:

Nu Get Package Manager

Type (or paste) the command below into the Console Manager.

Install-Package UmbracoCms

Then wait patiently until all components are downloaded.

Once complete, with no errors displayed, run the a Build and wait for the screen below:

Building Umbraco in VS

Now run project and allow it to modify the web.config.

If your compile runs successfully you will be greeted with the screen below.

Fill in the required info. Make sure you pick a good password!

Important: Then click the Customize button at the bottom of the form.

Setting Up the Database

The customize option brings us a Database Type selection drop down. Select the DB type applicable to your installation. Here we have chosen to use a SQL Server and to connect to the empty database we setup in the Preparation step above.

Umbraco SQL database install

If the step above went successfully, the next screen will offer you the option of loading a starter website or alternatively loading a blank system.

If you want to install another theme use the No Thanks option here so that you can upload your theme later.

If all goes well you will be presented with the screen below.

Success! Now the hard work starts.

Successful Umbraco Install  - Backend view


About the author

Umbraco Girl

Loves Umbraco!

Contact us