Multitenancy configuration parameters

A reference list of the parameters used to configure multitenancy in the values.yaml file. Use tenants to represent customer instances in the system.

General parameters

enabled
  • Description: Enables multitenant support.
  • Accepted values: true, false
commonTenantDatabaseName
  • Description: The name of the database to associate with the tenant data shared across all tenants.
  • Default value: "multitenant-common"
tenantDbPrefix
  • Description: The prefix prepended to a tenant name to form the name of its dedicated database.
  • Default value: "uno-tenant-"
Warning: tenantDbPrefix must not exceed 28 characters.
region
  • Description: The region to associate with the tenant.
  • Default value: "development"
auditMaxRetentionDuration
  • Description: The maximum duration for which audit logs are retained. After this duration, audit logs are deleted.
  • Default value: "P3650D"
auditCleanupFrequency
  • Description: The frequency for the cleanup task that deletes old audit logs.
  • Default value: "P1D"
tenantMetricsEnabled
  • Description: Flag for internal use only.
  • Default value: false

Resource parameters

trialMaxJobPerDay
  • Description: The daily usage limit for the tenant regarding task runs.
  • Default value: 500
trialMaxAIAgentPerDay
  • Description: The daily usage limit for the tenant regarding AI Agent calls.
  • Default value: 500
tokenPerJob
  • Description: The token value per task.
  • Default value: 1
tokenPerAIAgentCall
  • Description: The token value per AI Agent call.
  • Default value: 0.125

Lifecycle parameters

expirationCheckInterval
  • Description: The interval at which the system checks for expired tenants. Specify the format in ISO 8601 duration.
  • Default value: "PT6H"
trial.defaultExpiration
  • Description: The expiration time for the tenant (TRIAL). Specify the format in ISO 8601 duration.
  • Default value: "P30D"
trial.cleanupDelay
  • Description: The waiting period after a TRIAL tenant expires before the system transitions it to the REMOVED state.
  • Default value: "P60D"
subscribed.cleanupDelay
  • Description: The waiting period after a subscribed (non-TRIAL) tenant expires before the system transitions it to the REMOVED state.
  • Default value: "P366D"

Notification parameters

trialSupportLink
  • Description: The support email address or http(s) link to include in the tenant notification emails for trials. Optional.
  • Default value: "mailto:support@example.com"
subscribedSupportLink
  • Description: The support email address or http(s) link to include in the tenant notification emails for subscribed tenants. Optional.
  • Default value: "https://support.example.com"
eMailSender
  • Description: The name to include in the "from" field of the tenant notification emails. Optional.
  • Default value: "UnO SaaS"
eMailTenantReadySubject
  • Description: The custom subject for the email sent as notifications when a tenant is created. It uses ${TENANT_NAME} as a placeholder. Optional.
  • Default value: "Your UnO Tenant ${TENANT_NAME} is Ready"
eMailTenantReadyTemplate
  • Description: The custom template in HTML format for the email sent as notifications when a tenant is created. Optional. It uses placeholders such as ${TENANT_NAME}, ${TENANT_URL}, ${SUPPORT_LINK}, and ${SUPPORT_TXT}.

Justification parameters

The following parameters are located under the justification key.

justificationCategoryRequired
  • Description: Specifies whether the justification category is mandatory for tenants.
  • Accepted values: true, false
  • Default value: false
justificationTicketNumberRequired
  • Description: Specifies whether the justification ticket number is mandatory for tenants.
  • Accepted values: true, false
  • Default value: false
justificationDescriptionRequired
  • Description: Specifies whether the justification description is mandatory for tenants.
  • Accepted values: true, false
  • Default value: false
justificationCategories
  • Description: The list of all the possible justification categories for the Tenant Manager, comma separated.
  • Default value: Change Request,Trouble Ticket,New Application,Optimization,Emergency Change

Administrator parameters

The following parameters are located under the config.multitenant.admins key.

userIds
  • Description: Defines the list of tenant administrators (by user ID). These IDs have full access to the Tenant Manager.
groupIds
  • Description: Defines the list of tenant administrators (by group ID). The system grants access to the Tenant Manager to all users within these groups.
userIdFilters
  • Description: A list of regular expression patterns. If specified, users in the groupIds list must also have a user ID matching at least one pattern to gain access.
Note: The Tenant Manager URL is derived from the baseDomainName parameter under ingress section in the values.yaml file.