SaaS CMS has officially launched! Learn more now.

ARCHIVED This content is retired and no longer maintained. See the latest version here.

Recommended reading 

This document describes how to set up an EPiServer Commerce site (8.12 and above) to run on Azure Web Sites. In this scenario a Commerce Core site is installed and most steps can also be applied to sites via VS extension and installing NuGet packages. Refer to Azure Web Apps for more detailed information about Azure.


  • The Azure Management Portal requires an account with login details.
  • A specific cloud enabled license is required, refer to the EPiServer License Center to get this.
  • Deploying to cloud based websites requires that each deployed application and module is designed for cloud.

For sites upgraded from 7.5 and higher, refer to Upgrading and deploying Commerce to Azure Web Apps for more information.

Cloud website setup

Like EPiServer CMS webite on Azure, the Commerce website can be run on Azure Web Site environment with multiple instances. The website instances share the same Azure SQL database, and the blob storage in Azure is used for storing of the file binary data. Load balancing is applied and the Azure Service Bus manages events between the CMS websites.

Follow the steps below to create an EPiServer Commerce website running in an Azure Apps environment.

1. Creating a site

  • In Visual Studio, select Tools > Extensions and Updates menu. In the dialog, select Online and Search EPiServer CMS Visual Studio Extension then install extenstion. Refer to Visual Studio Gallery for more information about EPiServer Extension.
  • Create a new project by selecting New > Project > Visual C#, and then EPiServer > EPiServer Web Site. In the dialog select Empty, uncheck "Add EPiServer Search", to use search functionality when running in Azure see section "Search in Azure" on Deploying to Azure Web Apps.
  • Install the NuGet package EPiServer.Commerce, to latest version (or 8.12 at least).
  • Install the NuGet package EPiServer.Commerce.Azure to the project.
  • Add the cloud license to the website, this will be used and activated later when deploying the website to Azure.

2. Creating Azure resources

Refer to section "Creating Azure resources" on Deploying to Azure Web Apps for more information.

3. Updating configurations

Refer to section "Updating configuration" on Deploying to Azure Web Apps for more information.

4. Deploying

    • Refer to Deploying section on Deploying to Azure Web Apps for more information about how to deploy an EPiServer site.

      Note that since Commerce has two databases, we need to add two scripts in the Add SQL Script step:
      • EPiServer.Cms.Core.sql under [SolutionDir]\packages\EPServer.CMS.Core.x\tools\ to EPiServerDB
      • EPiServer.Commerce.sql under [SolutionDir]\packages\EPiServer.Commerce.Core.x\tools\ to EcfSqlConnection  

  • When the database has been successfuly created, run the Update-EPiDatabase command in the Package Manager Console.

5. Changing the site URL

6. Build site index

Build content index

Rebuild catalog index

  • Access Commerce Manager.
  • Go to Administration > System Settings > Search Index, click on Rebuild Index, the catalog index will be restored in your storage.

Note: If you are using LuceneSearchProvider as default search provider, you need to do some more extra steps:

  • Open Mediachase.Search.config, in SearchProviders, and set the attribute defaultProvider to LuceneAzureSearchProvider.
  • Set your connectionStringName so that the provider has the name="LuceneAzureSearchProvider" matching with your Azure Storage name (in connectionStrings.config) and storage="<container you want to index>".
  • Set the connectionStringName in Indexers tab matching with your Azure Storage name (in connectionStrings.config) and basePath is "<container where you want to store build info>".

Example of search config in Mediachase.Search.config, defined for using Lucene on Azure:

<?xml version="1.0" encoding="utf-8"?>
  <SearchProviders defaultProvider="LuceneAzureSearchProvider">
      <add name="LuceneSearchProvider" type="Mediachase.Search.Providers.Lucene.LuceneSearchProviderMediachase.Search.LuceneSearchProvider" 
        queryBuilderType="Mediachase.Search.Providers.Lucene.LuceneSearchQueryBuilder, Mediachase.Search.LuceneSearchProvider"
        storage="<your_physical_path_index>" simulateFaceting="true"/>
      <add name="LuceneAzureSearchProvider" type="Mediachase.Search.Providers.Lucene.LuceneAzureSearchProvider, Mediachase.Search.LuceneAzureSearchProvider"
        queryBuilderType="Mediachase.Search.Providers.Lucene.LuceneSearchQueryBuilder, Mediachase.Search.LuceneSearchProvider" 
        storage="indexcontainer" connectionStringName="EPiServerAzureBlobs" simulateFaceting="true"/>
  <Indexers basePath="indexcontainer" connectionStringName="EPiServerAzureBlobs"> 
    <add name="catalog" type="Mediachase.Search.Extensions.Indexers.CatalogIndexBuilder, Mediachase.Search.Extensions"/>

Note: You need to install Episerver.Commerce.Azure to use Mediachase.Search.LuceneAzureSearchProvider . 

See also

Do you find this information helpful? Please log in to provide feedback.

Last updated: May 26, 2015

Recommended reading