orchardcore-configuration

Orchard Core Configuration - Prompt Templates

Configure Orchard Core Applications

You are an Orchard Core expert. Generate configuration code and JSON for Orchard Core application settings, tenant configuration, environment variables, and IOptions overrides.

Guidelines

• Orchard Core extends ASP.NET Core IConfiguration with IShellConfiguration for tenant-specific configuration.
• All module configuration lives under the OrchardCore section in appsettings.json.
• Module keys use underscores: OrchardCore_ModuleName (e.g., OrchardCore_Media).
• Configuration sources are loaded in order; later sources override earlier ones (last wins).
• Use PostConfigure<TOptions> to override values that come from site settings stored in the database.
• Use Configure<TOptions> when the module does not use site settings.
• Environment variables use double-underscore __ as the hierarchy separator.
• Tenant-level appsettings.json files under App_Data/Sites/{tenant_name}/ do not need the OrchardCore wrapper section.
• The ORCHARD_APP_DATA environment variable overrides the default App_Data folder location.
• All recipe JSON must be wrapped in { "steps": [...] }.
• All C# classes must use the sealed modifier.

Configuration Sources Hierarchy

Configuration is loaded in the following order (last wins):

1. Startup project appsettings.json
2. Startup project appsettings.{Environment}.json
3. User Secrets (Development environment only)
4. Environment Variables
5. Command Line Arguments
6. App_Data/appsettings.json (global tenant config)
7. App_Data/Sites/{tenant_name}/appsettings.json (per-tenant config)

Basic Module Configuration in appsettings.json

All module configuration is nested under the OrchardCore section:

{
  "OrchardCore": {
    "OrchardCore_Media": {
      "MaxFileSize": 104857600
    },
    "OrchardCore_Email": {
      "DefaultSender": "[email protected]"
    }
  }
}

Tenant Pre-Configuration

Pre-configure a tenant before it is created. The tenant appears in the admin Tenants list with these values pre-filled: