--- title: "Setting Up Same Machine Multi-Tenancy With Provisioning" slug: "multi-tenancy-setting-up-multi-tenancy-with-provisioning" tags: ["Provisioning", "Server Architecture", "Multi-Tenant ", "Multi-Tenancy "] updated: 2026-05-04T14:47:52Z published: 2026-05-04T14:47:52Z --- > ## 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. # Setting Up Same Machine Multi-Tenancy With Provisioning Note:Decisions do not support the same-server self-hosted multi-tenancy setups. If users want to host tenant instances on the same server as Control, users must only use Internet Information Services (IIS) for hosting. ## Overview A [**Tenant Instance**](https://documentation.decisions.com/v9/docs/multi-tenancy-adding-and-setting-up-a-tenant-instance) represents one independently running instance within a [**Multi-Tenancy**](https://documentation.decisions.com/v9/docs/about-multi-tenancy) that contains the same application running on the [**Control Instance**](https://documentation.decisions.com/v9/docs/multi-tenancy-setting-up-a-control-instance?highlight=control%20instan) with its unique database. **Tenant Provisioning** is the method by which a Tenant Instance is added to a Multi-Tenancy using a **Decisions Studio**-based UI. This provides a local testing environment and a way of resource distribution without having to utilize a VM (virtual machine) and acts as an alternate method to establish a local Multi-Tenancy manually. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1692006692218.png) ### Prerequisites - A preconfigured [**Control****Instance**](https://documentation.decisions.com/v9/docs/multi-tenancy-setting-up-a-control-instance )**** - An Account that will be assigned to subsequent **Tenant****Instances** - A **Tenant Instance Folder** (to create one, perform steps 1-6 from the article [Multi-Tenancy: Adding and Setting up a Tenant Instance](https://documentation.decisions.com/v9/docs/multi-tenancy-adding-and-setting-up-a-tenant-instance#:~:text=Under%20Admin%C2%A0Account,the%20Tenant%20machine.%C2%A0 )) ### Important Considerations - **HTTPS Ports** and secured setup must be [manually](https://documentation.decisions.com/v9/docs/configuring-the-server-for-ssl-https )established on the instance outside the **Provisioning****UI**. --- ## Example 1. Right-click the newly added **Tenant****I****nstance** from the **Hosting** Folder and select **Host Instance Locally**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1741027171552.png) 2. From the resulting window, set **Hosting Type** to match the **Control Instance**and configure the settings listed under the IIS and Self-hosted sections. 3. If users want to make a secure connection to the tenant instance, they can enable "**Use Https Port**" and give the port number. HTTPS Ports and secured setup must be manually established on the instance. - Refer to [Configuring the Server for SSL (HTTPS)](https://documentation.decisions.com/v9/docs/configuring-the-server-for-ssl-https ). - Navigate to the `C:\Program Files\Decisions\Decisions Server\Instances`. - Open the instance folder > Settings.xml. Users can configure the secure connection settings and [restart](https://documentation.decisions.com/v9/docs/restart-decisions-application )the service of the instance. 4. Referring to the following table, configure the Database settings of the Tenant instance. It is recommended to use the same Database type for the Control and the Tenant instances. | Setting Name | Description | | --- | --- | | Use Local Connection (Enabled)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1741027849071.png) | Exposes a field to give the **Database Name** of the tenant instance. This will create a new database in the server where the Control Instance database is located. | | Use Local Connection (Disabled)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1741027863526.png) | Exposes a Drop-down to select the **MSSQL**, **POSTGRES**, and **AZURE** database types. For more information on all the database integration and configuration, refer to [External Database Integration](https://documentation.decisions.com/v9/docs/en/external-database-integration?highlight=Database%20Type ). | Control Instance using Azure Service Principle?If the Control Instance database is configured as **AZURE** and uses [Azure Service Principle](https://documentation.decisions.com/v9/docs/installing-decisions-using-azure-service-principal ) authentication, enabling the "**Use Local Connection**" option****while hosting the Tenant locally will not create a new database in AZURE. It is recommended to Disable this option and manually enter all the relevant details for the tenant instance. --- ### IIS Hosting Please review the [Installer Hosting Options](https://documentation.decisions.com/v9/docs/installer-hosting-options) for more information regarding IIS Setup. Configure the Tenant as per the following table. | Setting Name | Description | | --- | --- | | Hosting Type | Allows to select the type of hosting. Pick **IISHosting** from the drop-down | | Select Site | Allows to select the desired IIS Site from the drop-down | | Instance Base URL | Portal Base URL that will be used to access the Tenant Instance | | Database Settings | Allows to configure the detailed [Database Settings](/v9/docs/multi-tenancy-setting-up-multi-tenancy-with-provisioning#database-settings%20%20) | | Override Control Instance URL | An optional setting to bypass the Control Instance URL and establish a direct internal communication link between the Tenant Instance and the Control Instance. | | Specify Service Account | Allows to specify the service account details. Ensure to enter the Username in the following format: `.\[Username]`. Ensure the service account has the appropriate permissions to the Decisions Folder. | Sites not visible under 'Select Site'?To view the 'sites' from Internet Information Services (IIS), users must have appropriate permissions to access and read the IIS site or the parent level that encompasses the sites. 1. To start hosting the Tenant Instance, navigate to the Tenant Instance URL (Instance Base URL) in a browser. This first visit initializes the instance and begins provisioning. 2. Open **Internet Information Services (IIS) Manager**, and navigate to the Tenant Instance under the respective **Site's**(**Default Web Site**) folder. 3. Navigate to and open **progress.txt** under **C:\Decisions\Decisions Server\Instances\[TENANT NAME]** to observe the installation progress; re-open the file to check on the **Tenant's**progress. The installation will conclude when the "Application Boot Completed!" message is displayed. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2022-08-30_14h32_53.png ) 4. After installation, attempt to log into the **Tenant Instance** with the **Admin****Account**. If the Page is not working, open it in Incognito mode. If the Login Page loads in Incognito mode, visit the URL after clearing the browser cookies.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2022-06-01_15h06_55.png ) 5. Once the application is running successfully, users need to configure the recycling conditions from IIS, which handles the recycling of the hosted application every 29 hours. Open IIS > Application Pools > Click on the Instance Name and Configure the Application Pool Recycling Settings by **disabling** Fixed Intervals, Regular time intervals(in minutes). Then click Next, and Finish.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1692714642877.png) After successfully hosting the Tenant instance, assign the specific users to the tenant. Refer to the following article [Assigning Accounts to the Tenants/Control Instance](https://documentation.decisions.com/v9/docs/multi-tenancy-adding-and-setting-up-a-tenant-instance#assigning-accounts-to-the-tenantscontrol-instance ). --- ## Tenant Provisioning Actions The following chart represents the **Provisioning**actions made available upon right-clicking a **Tenant Instance** in the **System > Hosting Folder**. | Action | Description | Screenshot | | --- | --- | --- | | Add Instance Account | Used to add an Account from the Control to the Tenant Instance. Enabling 'Is Admin' adds the Account to the Admin Group on the Tenant. | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1741030001497.png) | | Edit Instance | Provides options to edit the Tenant's Instance Name, Instance Base URL, and Description. This window also displays the Tenant's Authentication Key. Override Login Page Logo can be used to change the logo displayed upon navigating to the login screen. | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1741029962662.png) | | Delete [Instance Name] Instance | Deletes/removes the instance from the Hosting Folder, prompted selecting YES. | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1741030540349.png) | | Enable/Disable Instance | If Disabled, users will not be able to log in to the Instance. And they might see the message "Either Instance Not Found or it is Disabled." | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1741029941521.png) | | Host Instance Locally | Hosts the Tenant locally via the Provisioning UI. See the example below for information on how to use this feature. | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1741030377235.png) | If Users encounter issues while configuring, refer to the following article for [Troubleshooting Multi-Tenant Environments](https://documentation.decisions.com/v9/docs/troubleshooting-multi-tenant-environments ). If the problem continues, please reach out to [support@decisions.com](mailto:support@decisions.com ). --- ## Feature Changes | Description | Version | Release Date | Developer Task | | --- | --- | --- | --- | | Add Option for Azure SQL on UI-Based Tenant Provisioning | [8.10.1](https://documentation.decisions.com/v99/docs/version-810x-release-notes ) | March 2023 | [DT-036429] | | Ability to Add Service Account Credentials To Be Used For Tenants In Hosting Menu | [8.13](https://documentation.decisions.com/v99/docs ) | August 2023 | [DT-038147] | | Ability to specify the Internal Control Instance URL From The Control | [8.13](https://documentation.decisions.com/v99/docs ) | August 2023 | [DT-038146] | --- For more information regarding Multi-Tenancy, see [Decisions Forum: Multi-Tenant](https://support.decisions.com/forum/forum23-multitenant.aspx ).