Skip to content

How to configure Tracardi to be multi tenant?

To configure Tracardi as a multi-tenant system, you need to follow these steps:

Understand Tracardi's Multi-Tenancy Concept

In Tracardi, multi-tenancy means that a single Tracardi container can serve data for multiple separated tenants. Each tenant's data is stored in a separate namespace within the storage, ensuring data isolation and separation between tenants. This feature is available only in commercial Tracardi version.

Configure Tracardi as Single Tenant (Default)

By default, Tracardi operates as a single tenant system, connecting to the namespace of a single tenant. The name of the tenant can be configured using the environment variable TENANT_NAME. If this variable is not set, the system will generate a random name for the tenant.

Enable Multi-Tenancy

To enable multi-tenancy in Tracardi, you need to set the environment variable MULTI_TENANT to "yes". This tells Tracardi container that it should serve multiple tenants. The tenant name will be defined based on your API domain. For example, if your API domain is, the tenant name will be set as "companyx" by removing all non-alphanumeric characters. All the data indices for each tenant will be prefixed with the tenant name, creating a namespace in the storage.

Prerequisites for Tenant Name

There are some prerequisites for the tenant name in Tracardi.

Length Requirement

The tenant name must be at least 5 letters long, excluding non-alphanumeric characters.


The tenant name cannot consist solely of numeric characters. It must include at least one non-numeric character.

Domain Structure

The tenant name must be part of a domain that has three parts. For example, a domain like "" will not create a valid tenant as it only has two parts ("com" and "mydomain"). However, a domain like "" will define a tenant with the name "xxx". Similarly, in the case of "," the tenant name will be "zzz".

Define Available Tenants

You can define the list of available tenants by setting the environment variable TENANT_API to the URL of the tenant manager microservice. This microservice will manage the list of tenants and provide the necessary functionality to create, update, and delete tenants.

Set Multi Tenant GUI

Set the environment variable called MULTI_TENANT to "yes". This setting will disable index management on the graphical user interface (GUI).

In a multi-tenant installation, managing indices is not available. Multi-tenant installations are designed to have access to the entire Elasticsearch cluster, rather than tenant index management.


If you encounter an issue while trying to start a multi-tenant Tracardi server API, you can check the logs for a specific error message: "Can not find tenant for this instance." This error indicates that the prerequisites for the tenant name have not been met. In other words, the tenant name provided does not meet the necessary criteria as discussed earlier. By reviewing the logs and ensuring that the tenant name meets the required prerequisites, you can resolve this issue and successfully start the multi-tenant Tracardi server API.

This document answers the following questions: - How to set-up multitenacy in Tracardi? - How to set-up GUI to be multi tenant installation? - How multi tenant setup works in Tracardi? - How tenants are differentiated in Tracardi? - How to enable tenant in Tracardi? - Is multi tenancy available in open-source version?