Deprecating the Default Tenant and Enabling Multi-Tenancy

Default Tenant & Multi-Tenancy

Default tenant is deprecated and multi-tenancy is enabled by default.

Multi-tenancy was introduced in Kestra 0.13. For backward compatibility with older versions (≤0.12), you could use the concept of a default tenant, which imitated the multitenancy feature with the so-called null-tenant or default tenant.

In Kestra 0.22, the default tenant functionality is deprecated and will be removed in the future. Sufficient migration time will be provided, along with a detailed migration guide for customers still using the default tenant.

How to keep the default tenant for now

To continue using the default tenant, set the defaultTenant configuration flag to true and tenants.enabled to false in your kestra.yml configuration file:

kestra:
  ee:
    tenants:
      enabled: false
      defaultTenant: true

In Kestra 0.22 and higher, defaultTenant is no longer enabled by default, so set that configuration option to true to keep using the default tenant.

Before 0.22.0

Here is the default multi-tenancy configuration before 0.22.0:

kestra:
  ee:
    tenants:
      enabled: false
      defaultTenant: true

After 0.22.0

Here is the default multi-tenancy configuration after 0.22.0:

kestra:
  ee:
    tenants:
      enabled: true
      defaultTenant: false