Skip to main content
Version: Next

Configure multi-tenancy

caution

Multi-tenancy is currently only available for Camunda 8 Self-Managed with authentication enabled through Identity.

To successfully configure multi-tenancy, you must do the following:

  • Ensure Identity is configured with a database.
  • Enable the multi-tenancy flag globally through Helm charts or via environment variables for each required component.

Multi-tenancy must be enabled for each required component. Using the single global flag with Helm charts is recommended.

Helm charts

When using Helm charts, you can enable multi-tenancy globally with the flag global.multitenancy.enabled. Visit the Helm chart configuration for additional details.

Environment variables

Without Helm charts, multi-tenancy can be enabled using environment variables. This feature must be enabled in all required components, see:

Unexpected behavior may occur if multi-tenancy is only enabled in some components.

Troubleshooting multi-tenancy

danger

Disabling multi-tenancy can lead to unexpected behavior if previously enabled with active tenants.

You may encounter unexpected or exceptional behavior if you configure multi-tenancy incorrectly.

This includes enabling multi-tenancy in some, but not all components. Multi-tenancy must be enabled in all components.

Problem: No external database is configured

Helm charts throw an error if multi-tenancy is enabled, but no external database is configured. A database is required by Identity when multi-tenancy is enabled.

Solution: Configure Identity with a database

Ensure Identity is configured with a database.