Class HostingSettings

Typed configuration options for hosting settings.

Inheritance

object

Namespace: Umbraco.Cms.Core.Configuration.Models

Assembly: Umbraco.Core.dll

Syntax

[UmbracoOptions("Umbraco:CMS:Hosting")]
public class HostingSettings

Constructors

View Source

HostingSettings()

Declaration

public HostingSettings()

Properties

View Source

ApplicationVirtualPath

Gets or sets a value for the application virtual path.

Declaration

public string? ApplicationVirtualPath { get; set; }

Property Value

Type	Description
string

View Source

Debug

Gets or sets a value indicating whether umbraco is running in [debug mode].

Declaration

public bool Debug { get; set; }

Property Value

Type	Description
bool	`true` if [debug mode]; otherwise, `false`.

View Source

LocalTempStorageLocation

Gets or sets a value for the location of temporary files.

Declaration

public LocalTempStorage LocalTempStorageLocation { get; set; }

Property Value

Type	Description
LocalTempStorage

View Source

MachineIdentifier

Gets or sets a stable identifier for this server instance used to track cache synchronization state.

Declaration

public string? MachineIdentifier { get; set; }

Property Value

Type	Description
string

Remarks

Set this when the machine name is not stable across restarts — for example on Azure App Service Linux, where the container hostname changes on each recycle. Use a value that is unique per server instance (e.g. the site name for single-server deployments, or a per-instance value for scale-out).

When not set, Umbraco automatically uses the WEBSITE_INSTANCE_ID environment variable on Azure App Service, or falls back to Environment.MachineName.

The value of SiteName is still appended when set, matching the behaviour of the default Environment.MachineName-based identifier.

The combined value of this setting and SiteName must not exceed 255 characters.

View Source

SiteName

Gets or sets a value specifying the name of the site.

Declaration

public string? SiteName { get; set; }

Property Value

Type	Description
string

View Source

TemporaryFileUploadLocation

Gets or sets a value for the location of temporary file uploads.

Declaration

public string? TemporaryFileUploadLocation { get; set; }

Property Value

Type	Description
string	/umbraco/Data/TEMP/TemporaryFile if nothing is specified.