Skip to main content

Configuration field reference

This inventory was taken from the current core-server configuration struct. Confirm it against the version you deploy. Types describe the implementation; duration syntax and accepted values need field-specific guidance.

YAML fieldImplementation type
displayedAppNamestring
httpHoststring
httpPortstring
enableCorsbool
externalUrlstring
tcpHoststring
tcpPortstring
tcpEnabledbool
logLevelstring
logClusterMessagesbool
logClientMessagesbool
auditLogEnabledbool
auditLogBatchSizeint
auditLogBatchTimeouttime.Duration
serverRolestring
clusterHostIpstring
clusterHostPortstring
clusterHostUrlstring
clusterStateRefreshIntervaltime.Duration
clusterStateExpiryDurationtime.Duration
clusterKeystring
httpRequestTimeouttime.Duration
wsHandshakeTimeouttime.Duration
outgoingMessageBufferSizeint
outgoingMessageBufferIntervalstring
subscriptionBatchIntervalstring
minCheckIntervalstring
presenceRefreshRatestring
maxRecurseDepthint
maxRequestBodySizeint
httpPathstring
websocketPathstring
restPathPrefixstring
healthCheckPathstring
serverStatusPathstring
adminDashboardEnabledbool
adminDashboardHttpPathstring
adminPasswordstring
authTypestring
authTokenLocationstring
authCookieNamestring
authTokenSecretstring
authTokenClockTolerancetime.Duration
pathToGoogleServiceAccountJsonstring
awsCognitoRegionstring
awsCognitoUserPoolIdstring
authTokenMaxLifeTimestring
authEmailDomains[]string
authEmailTenantSplitstring
authSessionLifetimetime.Duration
smtpHoststring
smtpPortstring
smtpUserstring
smtpPasswordstring
fromEmailAddressstring
tenantIdClaimKeystring
metricsIntervaltime.Duration
persistenceTypestring
persistenceMessageBufferSizeint
timeSeriesPersistenceTypestring
timeSeriesPersistenceMaxRecordsPerWriteint
timeSeriesPersistenceMaxTimeBetweenWritesstring
awsKeyIdstring
awsKeystring
awsRegionstring
pgHoststring
pgPortstring
pgUserstring
pgPasswordstring
pgDatabasestring
environmentstring
reportStorageTypestring
reportFileHttpBasePathstring
reportFileDirectorystring
reportS3BucketRegionstring
reportS3BucketNamestring
userFileUploadDirectorystring
userFileUploadTypestring
userFileUploadBucketNamestring
userFileUploadBucketRegionstring
limitQueriesToRealmTablebool
thirdPartyProtocolEndpoints[]ThirdPartyProtocolEndpointDefinition

Nested third-party protocol endpoint fields​

The following fields belong to entries in thirdPartyProtocolEndpoints, not to the root configuration.

YAML fieldImplementation type
dataProtocolstring
transportProtocolstring
addressstring
realmIdstring
tenantIdstring
categoryIdstring

See configuration guidance and identity deployment for the procedures already documented.