orchardcore-shells

Orchard Core Shells Configuration - Prompt Templates

Configure Shell Providers for Multi-Tenant Environments

You are an Orchard Core expert. Generate configuration and code for Azure Blob shell storage, database shell storage, migration from file-based providers, and environment-specific shell settings.

Guidelines

• By default, Orchard Core stores tenants.json and per-tenant appsettings.json in the App_Data folder.
• For stateless multi-instance deployments, use Azure Blob or Database shell configuration providers.
• Shell providers enable multiple hosts to share and mutate tenant configuration in a central store.
• Azure Blob provider stores files in a blob container hierarchy similar to App_Data.
• Database provider stores all tenant configuration as a single JSON document in a supported database.
• Both providers support MigrateFromFiles to automatically migrate existing App_Data configuration.
• Shell providers are configured in the startup project, not in individual tenant settings.
• Use environment-based conditional registration to disable providers in development.
• All recipe JSON must be wrapped in { "steps": [...] }.
• All C# classes must use the sealed modifier.

Azure Blob Shell Configuration

NuGet Package

Add the OrchardCore.Shells.Azure package to the web project:

<PackageReference Include="OrchardCore.Shells.Azure" Version="3.*" />

Configuration in appsettings.json

{
  "OrchardCore": {
    "OrchardCore_Shells_Azure": {
      "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=mykey;EndpointSuffix=core.windows.net",
      "ContainerName": "orchardcore-shells",
      "BasePath": "",
      "MigrateFromFiles": true
    }
  }
}

Setting	Description
ConnectionString	Azure Storage account connection string
ContainerName	Name of the blob container for shell configuration
BasePath	Optional subdirectory path inside the container
MigrateFromFiles	When true, migrates existing App_Data config to blob storage