Web Developement
Now Reading
How to Install Umbraco using NuGet
0

How to Install Umbraco using NuGet

by Adrian RandallJuly 24, 2016

Installing Umbraco is pretty simple but it’s always good to have a reference as general it isn’t something you do too often. This tutorial aims to step you through how to install Umbraco on your local computer so if there is anything I have missed please comment below.

What you need

  1. A Windows PC (mine is running Windows 10)
  2. Microsoft Visual Studio (I use the Community Edition because it’s free, you can find it here https://www.visualstudio.com/en-us/products/visual-studio-community-vs.aspx)
  3. Microsoft SQL Server with Tools (I use the 2014 version which can be found here https://www.microsoft.com/en-au/download/details.aspx?id=42299)
  4. Microsoft .NET 4.5 installed
  5. IIS Enabled

Let’s Get Started

What we are going to do is open Visual Studio, install Umbraco with NuGet and they get it running on a local domain called dev.umbraco.com. If you want to call the project something different then just swap dev.umbraco.com for your project name such as dev.mynewblog.com.

  1. First lets run Visual Studio as Administrator by right clicking it and selecting ‘Run as administrator’
    run-as-administrator
  2. From here select New Project -> the ASP.NET Web Application (Visual C#) and enter your project name and save location.
    setup-new-asp-net-web-application
  3. On the next popup select Empty as the ASP.NET 4.5.2 Template you want to use and if the option to configure Microsoft Azure pops up just hit ‘Cancel’empty-asp-template
  4. You should now have a black application setup and are nor ready to install Umbraco. Open the NuGet Package Manager console by selecting Tools->NuGet Package Manager->Package Manager Console.
    nuget-package-manager-console
  5. In the NuGet package manager console run the command to install the latest stable version of the Umbraco CMS. It changes regularly at at the time of doing theis tutorial it was at 7.4.3. However to find the latest version command just click here https://www.nuget.org/packages/UmbracoCms/. For now though run “Install-Package UmbracoCms -Version 7.4.3”.
    install-ubraco-with-nuget-package-manager
    This may take around 2-5 minutes.
  6. Once it’s been installed I like to add all Umbraco components to the project so I can see them. In the Solution Explorer click the ‘Show All Files button, then right click each new folder/file and select Include in Project
    show-all-files-visual-studio-community
  7. Once that’s all done from the tool bar select Build->Rebuild Solution
  8. Now we are ready to link our domain to the project. Run Notepad as an Administrator and open C:\Windows\System32\drivers\etc\hosts. Now as the last record add
    127.0.0.1 dev.umbraco.com
    notepad-hosts-file
     
  9. Now open IIS Manager and setup the bindings by adding a new Website (which will automatically create you a new Application Pool) and then configure the site for the domain name you just setup)
    iis-add-websiteiis-website-location-setup
  10. If this is the first time you’re setting up a .NET Application you may get a common error which is:
    “This configuration section cannot be used at this path. This happens when the section is locked at a parent level. Locking is either by default (overrideModeDefault=”Deny”), or set explicitly by a location tag with overrideMode=”Deny” or the legacy allowOverride=”false”. 

    To fix this you need to:

    • Click “Start button”
    • in the search box, enter “Turn windows features on or off”
    • in the features window, Click: “Internet Information Services”
    • Click: “World Wide Web Services”
    • Click: “Application Development Features”
    • Check (enable) the features. I checked all but CGI.
  11. No if you go to http://dev.umbraco.com/ in a browser you should be able to see the install page of Umbraco.
    Install Umbraco Page
  12. Now just fill out youe Name, email and default password and click Install. If you’d like to use a different database (such as MSSQL Server) then just click Customize and enter the database details.
  13. The next screen you should see is the Umbraco admin area and you will also be able to navigate to the front end are of the site showing the Fanoe theme
    umbraco-default-admin umbraco-default-front-end
About The Author
Adrian Randall
I'm a digital marketing specialist, love working on digital business and coding on just about anything. I'm the founder of Arcadian Digital and this site shares some of our knowledge and practices.

Leave a Response