--- title: "Licensing Multi-Tenancy" slug: "multi-tenancy-licensing" updated: 2026-03-26T20:56:46Z published: 2026-03-26T20:56:46Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Licensing Multi-Tenancy ## Overview Similar to other [Decisions Installations](https://documentation.decisions.com/v9/docs/installation-guide), [Multi-Tenant](https://documentation.decisions.com/v9/docs/about-multi-tenancy) environments require proper licensing to be able to run their platform. [Controls](https://documentation.decisions.com/v9/docs/multi-tenancy-setting-up-a-control-instance) and [Tenants](https://documentation.decisions.com/v9/docs/multi-tenancy-adding-and-setting-up-a-tenant-instance) are considered separate instances because they have different databases, so each Control and Tenant require its own license. The following document demonstrates how to establish licensing for a Multi-Tenancy. For more information on Licensing, refer to [Decisions License](https://documentation.decisions.com/v9/docs/licensing-a-server). --- ## How to apply for the license? Currently, there are three ways an admin user can apply for the license: | Ways to apply the license | Control Instance | Control and Tenant hosted on same machine | Tenants hosted on Same Machine | Tenants hosted on Different Machine | | --- | --- | --- | --- | --- | | - License Utility tool | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677580500937.png) | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677580480857.png) | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677580480857.png) | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677580480857.png) | | - Self-Licensing - Environment Variables | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677580505911.png) | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677580590827.png) | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677580590827.png) | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677580629722.png) | The next section explains the step-by-step procedure for applying the license. --- ## Licensing Control Instance via Utility To apply the license to the Control Instance via the Utility tool, refer to [Applying for a License via utility](https://documentation.decisions.com/v9/docs/licensing-a-server?highlight=Applying%20for%20a%20License%20via%20utility ). --- ## Licensing Tenant Instance ### Self-Licensing [Self-Licensing](https://documentation.decisions.com/v9/docs/self-service-licensing) is the most recommended way of licensing an Instance. All instances including Control and Tenant Instances can be applied via Self-Licensing. Following are the steps to configure the Self-Licensing. 1. Navigate to **System > Settings**; right-click **Licensing Setting**, then click **Edit Licensing Settings**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-18_11h29_42.png) 2. From the **Edit License Server Settings** window, Enable **Allow License Requests**, select the desired [**License Server Type**](https://documentation.decisions.com/v9/docs/licensing-a-server?highlight=Types%20of%20licenses ), then Enable **Multi-Tenant License**. 3. Provide the licensing details referring to the following table. | Variable | Function | Example | | --- | --- | --- | | Licensed Company ID | Enter the license ID for the container's instance. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | | Licensed Company Name | Enter the company name attached to the license's ID. | Decisions | | Email Contact for License | Enter a contact email for the provided license. | example@email.com | | License Contact Phone | Enter a Phone number for contacting reference. | (123)-456-7890 | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-18_11h33_49.png) 4. After saving the License Server Settings, [Restart](https://documentation.decisions.com/v9/docs/restart-decisions-application ) the Decisions service. This will generate a license request to [support@decisions.com](mailto:support@decisions.com ). Once the support team approves the license request, all the tenants will be licensed immediately and you will receive the "License Received and Installed" notification. 5. Navigate back to **License Settings**, Right-click Licensing Settings and select **Check For License**. To verify that the license has been applied successfully. If the License is not successfully applied, right-click Licensing Settings and select **Force Request Now**. 6. After receiving the "License Received and Installed" notification, restart the**Instance**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-18_11h37_50.png) --- ### Licensing via Environment Variables If the Control instance and the Tenants are hosted on the same machine, system administrators can apply the license to all instances simultaneously. This can be done by adding the System Environment Variables for Licensing. Following are the steps to configure the Environment Variables for Licensing. 1. Navigate to **Windows****Start**> search for **Edit the system environment variables**. From the search results, click on **Edit the system environment variables**.******System Properties** dialog box appears.**![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677499505214.png )** 2. Navigate and click on **Environment Variables**. Environment Variables dialog box appears. Under **System variables**>**New.**Enter the following variables one by one.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1677499252942.png ) | Environment Variable | Function | Example | | --- | --- | --- | | DECISIONS_LICENSECOMPANYID | Enter the license ID for the container's instance. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxx | | DECISIONS_LICENSECOMPANYNAME | Enter the company name attached to the license's ID. | Decisions | | DECISIONS_LICENSECONTACTEMAIL | Enter a contact email for the provided license | example@email.com | | DECISIONS_LICENSETYPE | Enter the [license type](https://documentation.decisions.com/v9/docs/self-service-licensing?highlight=self%20ser#:~:text=a%20Server.-,License%20Server%20Type,-There%20are%20six ) of the container. This will likely be either 'Enterprise Production' or 'EnterpriseNonProduction' | EnterpriseProduction | 3. Once all the System variables are added. Restart the Windows System. This will auto-restart the Decisions server and also generate a license request to [support@decisions.com](mailto:support@decisions.com ). Once the support team approves the license request, all the tenants including the control instance will be licensed immediately. 4. Navigate to **System > Settings**; right-click **Licensing Setting**, then select **Check for License**. To verify that the license has been applied successfully. --- If there is any difficulty in applying licenses to the instances, kindly reach out to [support@decisions.com](mailto:support@decisions.com).