Install Ucommerce on Umbraco Cloud

This article will explain how you can get started with Ucommerce on Umbraco Cloud. It is assumed that you already have setup your Umbraco Cloud environments. If you are interested in how to setup Umbraco Cloud, you can find more information here.

When you have finished the installation, you will have all the benefits from Umbraco Cloud on Ucommerce, like below e.g.

Ucommerce on a local Umbraco Cloud Environment

When you are going to install Ucommerce there is some manually steps that you have to follow before the installation is succeed and you can start using Ucommerce.

Add a new connection

When you are on your local environment, your Umbraco Cloud use a SQL CE database, which Ucommerce doesn't support.

The first thing that you need to do is to setup an empty SQL Express/Enterprise Database, which is going to be your local Ucommerce database. After you have created the database, you need to add a connection string for that database in the web.config.

    
    <connectionStrings>
    	<remove name="umbracoDbDSN" />
    	<!--Connection string for Umbraco SQL CE database-->
    	<add name="umbracoDbDSN" connectionString="Data Source=|DataDirectory|\Umbraco.sdf" providerName="System.Data.SqlServerCe.4.0" />
    	<!-- Important: If you're upgrading Umbraco, do not clear the connection string / provider name during your web.config merge. -->
    	<!--Connection string for your empty Ucommerce Database-->
    	<add name="Ucommerce" connectionString="server=YOUR_SERVER;database=YOUR_DATABASE;user id=YOUR_USER;password=YOUR_PASSWORD" providerName="System.Data.SqlClient" />
    </connectionStrings>

When you install Ucommerce, Ucommerce looks for a connection string with a name equal to "Ucommerce". Therefore, is it important that you use Ucommerce as value for the name of the connection string.

If you want Umbraco to use the same database as Ucommerce, just let the connectionStrings section be empty and remove the value from umbracoConfigurationStatus in appSettings.

    
    <appSettings>
    	<!--
      Umbraco web.config configuration documentation can be found here:
      http://our.umbraco.org/documentation/using-umbraco/config-files/#webconfig
      -->
    	<add key="umbracoConfigurationStatus" value="" />
    	...
    </appSettings>
    <connectionStrings>
    </connectionStrings>