---
title: "Deploy Sitecore Connect for Content Hub in a new PaaS environment"
slug: "deploy-sitecore-connect-for-content-hub-in-a-new-paas-environment"
abstract: "How to deploy the Sitecore Connect for Content Hub connector in a new PaaS environment."
---
# Deploy Sitecore Connect for Content Hub in a new PaaS environment

This topic describes how to use the Sitecore Azure Toolkit (SAT) to include the Sitecore Connect for Content Hub (SCCH) connector in a new Sitecore Azure Cloud Service (Paas) environment. The procedure depends on whether you have a Sitecore Experience Manager (XM) or Sitecore Experience Platform (XP) installation.

> [!note]
> If you have an existing Sitecore Azure PaaS environment, use the instructions in [Deploy Sitecore Connect for Content Hub in an existing PaaS environment](https://doc.sitecore.com/xp/en/developers/connect-for-ch/51/connect-for-content-hub/deploy-sitecore-connect-for-content-hub-in-an-existing-paas-environment.html "Deploy Sitecore Connect for Content Hub in an existing PaaS environment") instead.

<details>
<summary><h2>Prepare for installation</h2></summary>

This section explains what you must prepare before adding the Sitecore Connect for Content Hub (SCCH) connector to the Sitecore Azure Toolkit (SAT) configuration.

Before you add the SCCH module for SAT, you must have the following:

- An Azure account with access to Azure cloud storage with Azure Storage Explorer.

To prepare for installation, download the following resources:

- The Sitecore Azure Toolkit available at the [Sitecore download page](https://dev.sitecore.net/Downloads/Sitecore_Azure_Toolkit.aspx).
- The Sitecore Identity WDP package available at the [Sitecore download page](https://dev.sitecore.net/en/Downloads/Sitecore_Experience_Platform.aspx).
- The Sitecore Connect for Content Hub (SCCH) 5.1 WDP package available at the [Sitecore download page](https://dev.sitecore.net/Downloads/Sitecore_Connect_for_Content_Hub.aspx).
- The Sitecore Experience Platform (XP) WDP package available at the [Sitecore download page](https://dev.sitecore.net/en/Downloads/Sitecore_Experience_Platform.aspx) of the Sitecore version you are using, in the **Download options for Azure AppService** section.
- The SXP ARM template script folder `Sitecore <version>\<typology>`, available at [Sitecore Azure Quickstart Templates Github](https://github.com/Sitecore/Sitecore-Azure-Quickstart-Templates).
- The SCCH ARM template script `azuredeploy.json`, available at [Sitecore Azure Quickstart Templates Github](https://github.com/Sitecore/Sitecore-Azure-Quickstart-Templates) in the `Connectors\SCCH <version>\<typology>` folder

> [!note]
> For a comprehensive look at SAT deployment steps, see the [Sitecore Azure Toolkit Overview](https://doc.sitecore.com/xp/en/developers/sat/21/sitecore-azure-toolkit/getting-started-with-the-sitecore-azure-toolkit.html) and the [Sitecore Azure Toolkit Deployment Guide](https://doc.sitecore.com/xp/en/developers/sat/21/sitecore-azure-toolkit/deploy-a-new-sitecore-environment-to-azure-app-service.html) .

</details>

<details>
<summary><h2>Deploy SXP with SCCH to Azure on XM</h2></summary>

To enable the SAT bootloader to perform post-step or transformation instructions, you must prepare the template scripts and bootloader resources and add them to Azure.

For Sitecore XM installation:

1. Extract all the content in Sitecore Connect for Content Hub 5.1 WDP package to a new folder named, for example, `WDP`. Navigate to the `Content\Website\bin\scch` folder.
2. For Sitecore XM version 10.0 and 10.1, copy the `Microsoft.Extensions.DependencyInjection.Abstractions.dll` assembly to the `Content\Website\bin` folder.
3. For all versions of Sitecore XM, copy the `Microsoft.Extensions.Caching.Abstractions.dll` assembly to the `Content\Website\bin` folder.
4. Repack the contents of the `WDP` folder into a new WDP package, and name it `scwdp.zip`, replacing the `scwdp.zip` in the original download.
5. In Azure Storage Explorer, upload the following files to Azure blob Containers:

    | File | Source | URL parameter |
    | --- | --- | --- |
    | `azuredeploy.json` | Where you downloaded the SCCH ARM template script. | Bootloader template URL |
    | `scwdp.zip` | `Content\Website\bin` | SCCH 5.1 template URL |
    | `Sitecore.Cloud.Integration.Bootload.wdp.zip` | `Sitecore Azure Toolkit\resources\{version}\Addons` | Bootloader WDP URL |
    | `bootloader.json` | Where you downloaded the SXP ARM template script. | ARM template URL |

6. In Azure Storage Explorer, for each uploaded file, click **Copy URL** and save the URL to use as the URL parameter mentioned in the table.

    ![Azure Storage Explorer dialog with uploaded files](https://doc.sitecore.com/api/markdown-image/xp/en/developers/connect-for-ch/51/connect-for-content-hub/images/azure_storage_explorer_preview.png)

7. On your server, in the *Sitecore Platform ARM template* folder, open the `azuredeploy.parameters.json` file.
8. Add a new parameter named `modules`, and fill in the URLs you saved:

    ```csharp
    "modules": {"value": {"items": [
        {"name": "bootloader","templateLink": "<Bootloader template URL>","parameters": {"msDeployPackageUrl": "<Bootloader WDP URL>"}},
        {"name": "SCCH 5.1","templateLink": "<SCCH 5.1 template URL>","parameters": {"msDeployPackageUrl": "<ARM template URL>"}}
    ]}}}
    ```

9. Continue with the steps of deploying a new Sitecore environment to the Microsoft Azure App service. In the final step, after you invoke the deployment command in PowerShell, wait for the PowerShell script to complete all the tasks.
10. In the Azure resource group, on the **Deployments** tab, verify the deployment status for the bootloader and SCCH 5.1:

    ![Deployments tab in the Azure resource group dialog](https://doc.sitecore.com/api/markdown-image/xp/en/developers/connect-for-ch/51/connect-for-content-hub/images/image2.png)

</details>

<details>
<summary><h2>Deploy SXP with SCCH to Azure on XP</h2></summary>

To enable the SAT bootloader to perform post-step or transformation instructions, you must prepare the template scripts and bootloader resources and add them to Azure.

For Sitecore XP installations:

1. In Azure Storage Explorer, upload the following files to Azure blob Containers:

    | File | Source | URL parameter |
    | --- | --- | --- |
    | `azuredeploy.json` | Where you downloaded the SCCH ARM template script. | Bootloader template URL |
    | `scwdp.zip` | `Content\Website\bin` | SCCH 5.1 template URL |
    | `Sitecore.Cloud.Integration.Bootload.wdp.zip` | `Sitecore Azure Toolkit\resources\{version}\Addons` | Bootloader WDP URL |
    | `bootloader.json` | Where you downloaded the SXP ARM template script. | ARM template URL |

2. In Azure Storage Explorer, for each uploaded file, click **Copy URL** and save the URL to use as the URL parameter mentioned in the table.

    ![Azure Storage Explorer dialog with uploaded files](https://doc.sitecore.com/api/markdown-image/xp/en/developers/connect-for-ch/51/connect-for-content-hub/images/azure_storage_explorer_preview.png)

3. On your server, in the *Sitecore Platform ARM template* folder, open the `azuredeploy.parameters.json` file.
4. Add a new parameter named `modules`, and fill in the URLs you saved:

    ```csharp
    "modules": {"value": {"items": [
        {"name": "bootloader","templateLink": "<Bootloader template URL>","parameters": {"msDeployPackageUrl": "<Bootloader WDP URL>"}},
        {"name": "SCCH 5.1","templateLink": "<SCCH 5.1 template URL>","parameters": {"msDeployPackageUrl": "<ARM template URL>"}}
    ]}}}
    ```

5. Continue with the steps of deploying a new Sitecore environment to the Microsoft Azure App service. In the final step, after you invoke the deployment command in PowerShell, wait for the PowerShell script to complete all the tasks.
6. In the Azure resource group, on the **Deployments** tab, verify the deployment status for the bootloader and SCCH 5.1:

    ![Deployments tab in the Azure resource group dialog](https://doc.sitecore.com/api/markdown-image/xp/en/developers/connect-for-ch/51/connect-for-content-hub/images/image2.png)

</details>