Here’s a simple step-by-step guide on how to install Umbraco manually on our ASP.NET Hosting service plans. Umbraco is a formidable ASP .NET open source CMS (content management system). Furthermore, it is a leading open source CMS and used by organizations and individuals worldwide for the management and distribution of online content. It’s very easy to install, manage, and maintain. In addition, given that it’s an open source ASP.NET CMS as a result it provides the flexibility to customize the source code.
This tutorial will quickly show you how to install Umbraco on our Windows-based servers using the .NET EDGE hosting package because it supports the following:
- Umbraco 7.5.9
- ASP.NET 4.6
- Microsoft SQL Server 2012
- Windows 2012 Server
How to Install Umbraco Manually
Step 1: Create a Microsoft SQL Server Database:
Actually, the first step is to create a Microsoft SQL Server database through the control panel. So let’s log into the control panel (control panel login url is provided in your new account welcome email):
Furthermore, once logged in, click on the “Databases” link on the left and then click on the “Add Database” button:
Next, provide the database details by completing the form:
- Database name: This is a required field, you’ll notice that your hosting/subscription’s username is already in there with an underscore “_” (e.g. “myusername_”) type in the name for your database after the underscore (e.g. “myusername_dnn”).
- Database server: Select the default server for MS SQL (not MySQL).
- Related site: If you have more than one hosting/subscriptions in your control panel, select the appropriate site from the drop down.
Make sure that the “Create a database user” checkbox is check.
- Database user name: Enter the name for your database user.
- New password: Enter a password for the database user.
- Confirm password: Re-enter the password for confirmation.
Most of all, make sure that the “User has access to all databases within the selected subscription” checkbox is selected. Finally, go ahead and click on the “Ok” button:
As a result, you’ll get a page confirming that the database has been created:
Step 2: Verify ASP.NET Settings Are Correct:
The next step in this how to install Umbraco guide is to confirm the correct setting for ASP.NET because without doing so may cause application errors. So while still logged into the control panel, click on the “Websites & Domains” link on the left:
And then click on the “ASP.NET Settings” button:
First of all, make sure that the .NET Framework version (under “Framework version”) is at least version 4.5. In this case, we have version 4.6 which is good:
Ultimately, given that Umbraco is written in c#, let’s go ahead and select c# as the default webpage language under “Compilation and debugging”:
And next scroll down to the “Code access security” and make sure that the CAS trust level is set to “Full”:
Consequently, if everything looks good, proceed further and click on “OK” to apply the settings.
Step 3: Download, Unzip & Prepare Umbraco:
Meanwhile, visit https://our.umbraco.org/contribute/releases/ to download Umbraco. For the purposes of this how to install Umbraco tutorial, we worked with release version 7.5.9 at the time of writing.
Furthermore, go ahead and zip the downloaded file to a folder on your local PC. Next, open the web.config – we need to do some edits to this important file before uploading the unzipped files/directories to the hosting server.
- Configure Database Connection String:
In the meantime, while logged into the control panel, click on the Databases link on the left. Next, click on the Connection Info button/link (under the database you created in Step 1) to display the connection information for that database:
At this point, take note the database connection information. Next, locate the connectionStrings parameter in the web.config:
In any case, modify it to look similar the one below while making sure that you use the appropriate values for your own database connection information:
- Prevent “Validation of viewstate MAC failed” Error
Next, locate the pages parameter:
and modify it to:
In addition, add the following
<machineKey validationKey="10659C7651FF6D1966D4A9800BD154F48CBF801C7FF38EB33E2332C1B8A7673FA861603FEB516366E39269CA4993F427E8F8E914F74639594F3883057CE0C38D" decryptionKey="5B65EE6184FB8A8450221F573FADB3EFE760DDF5643A8A7F5830E672B266306F" validation="SHA1" decryption="AES" />
inside <system.web> and after <pages>…..<pages /> parameters.
- Set-up & Configure Email:
This is optional, but if you want enable email sending ability for the Umbraco installation, while still logged into the control panel, click on the “Mail” link on the left and then click the “Create Email Address” button:
Fill the form and click on the “OK” to complete the email creation process. Also, locate the following:
<mailSettings> <smtp from="firstname.lastname@example.org"> <network host="127.0.0.1" userName="username" password="password" /> </smtp> </mailSettings>
section in the web.config and modify it to reflect the email you just created. Most of all, for the host attribute, you can use the server IP address or hostname.
Step 4: Upload Unzipped Umbraco Files and Set Permissions
By and large, we’re now ready to upload the unzipped Umbraco files to the root folder httpdocs of the hosting server. Next, visit https://our.umbraco.org/documentation/Getting-Started/Setup/Install/permissions for the list of folders/files and permissions to set for each.
First and foremost, to do this make sure you’re logged into the control panel then click on “Websites & Domains” and click the File Manager button/link:
Next (to the far right) to each folder or file you will see a button, click on it and select the “Change Permissions” option to set the permissions for that folder or file.
Therefore, set permissions as indicated in the image above for Plesk IIS Worker Process Identity Account. Also, for each permission setting be sure to uncheck “Allow inheritable permissions from the parent to propagate to this object and all child objects” and make sure “Replace permission entries on all child objects” is checked.
Then email email@example.com with a request to add necessary permissions on httpdocs folder for anonymous user.
Step 5: Complete Installation
At this point, you’re now ready to complete the installation by visiting your website url (i.e. http://yoursiteurl…) and follow the steps Umbraco provides to complete the installation process!