How to upgrade from uSkinned Site Builder for Umbraco 8 to Umbraco 9

Make sure you are running the latest version of uSkinned Site Builder for Umbraco 8 before completing these steps.

This guide also assumes that you have not made any changes to uSkinned code, Document Types, Data Types etc.

If you have made your own changes then you will need to migrate these changes yourself.

The Umbraco 8 to 9 migration guide can be found here.

Step 1

Create a new Umbraco 9 and install uSkinned Site Builder for Umbraco 9.

Follow our guide here if you are unsure how to do this.

Step 2

Install uSync against your new Umbraco 9 website.

dotnet add package uSync

Run your website. This will create uSync files in ~/uSync/v9

Step 3

Go to your Umbraco 9 website directory and delete the contents of:

~/wwwroot/media/

Go to your Umbraco 8 website and copy the contents of:

~/media/

Paste your copied media into your Umbraco 9 website directory at location:

~/wwwroot/media/

Step 4

It is very important that you take a backup of your Umbraco 8 database before proceeding with the next steps.

Locate the following file within your Umbraco 9 website directory:

~/appsettings.Development.json

Update the connection string to point to your Umbraco 8 database and set UpgradeUnatended to true.

{
  "$schema": "https://json.schemastore.org/appsettings.json",

  "ConnectionStrings": {
    "umbracoDbDSN": "Server=.;Database=DocsSite;Integrated Security=true"
  },
  "Umbraco": {
    "CMS": {
      "Unattended": {
        "InstallUnattended": true,
        "UpgradeUnattended": true,
        "UnattendedUserName": "Admin User",
        "UnattendedUserEmail": "admin@admin.com",
        "UnattendedUserPassword": "1234567890"
      }
    }
  }
}

Step 5

Run your website and login to the Umbraco CMS. Dont worry if you see an error when browsing the frontend of your website at his stage.

Go to the Settings (Section) > uSync (node) > Import Settings

When the settings import is complete your website will be upgraded to Umbraco 9.

#h5yr