Camunda 8 system configuration

General settings

YAML path	Default value	Description
zeebe.enabled	false	Toggles whether Optimize should attempt to import data from the connected Zeebe instance.
zeebe.name	zeebe-record	The name suffix of the exported Zeebe records. This must match the record-prefix configured in the exporter of the instance.
zeebe.partitionCount	1	The number of partitions configured for the Zeebe record source.
zeebe.maxImportPageSize	200	The max page size for importing Zeebe data. Increasing it can help Optimize catch up faster when imports lag, but it uses more memory per fetch; decreasing it reduces memory use and per-query load on Elasticsearch/OpenSearch, but it can increase import lag.

Licensing

Camunda 8 Self-Managed only

Installations of Camunda 8 Self-Managed which require a license can provide their license key to the components as an environment variable:

Environment variable	Description	Default value
CAMUNDA_LICENSE_KEY	Your Camunda 8 license key, if your installation requires a license.	None

For Helm installations, license keys can be configured globally in your values.yaml file. See the Helm installation documentation for more details.

note

Camunda 8 components without a valid license may display Non-Production License in the navigation bar and issue warnings in the logs. These warnings have no impact on Optimize startup or functionality. To obtain a license, visit the Camunda Enterprise page.

Settings required for multi-tenancy

Camunda 8 Self-Managed only

For more information on multi-tenancy in Camunda 8 Self-Managed environments, refer to this page.

To use multi-tenancy, the feature must be enabled across all components.

YAML path	Default value	Description
multitenancy.enabled	false	Enables the Camunda 8 multi-tenancy feature in Optimize.
security.auth.ccsm.baseUrl	null	The base URL of Identity.

Settings related to Camunda user tasks (formerly Zeebe user tasks)

Camunda 8 Self-Managed only

For more information on user task reporting in Camunda 8 Self-Managed, refer to our user task analytics documentation.

YAML path	Default value	Description
ui.userTaskAssigneeAnalyticsEnabled	true	Enables assignee based analytics in Camunda 8 Self-Managed Optimize.