--- title: "Setting Up Tenant Instance on Separate Machines" slug: "multi-tenancy-adding-and-setting-up-a-tenant-instance" updated: 2025-06-30T16:23:40Z published: 2025-06-30T16:23:40Z --- > ## 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 Tenant Instance on Separate Machines ## Overview In a **Multi-****Tenancy**, a **Tenant****Instance**represents an independent running **Instance**. This Instance consists of an identical copy of the application running on the [**Control****Instance**](https://documentation.decisions.com/v9/docs/multi-tenancy-setting-up-a-control-instance) with its unique database. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1692006961136.png) The following document discusses hosting a **Tenant Instance** on separate machines within a Multi-Tenant environment. Important! - If hosting the Tenant instance and the Control Instance on the same server, it is strictly recommended to host both applications on Information Internet Services (IIS). - If the Tenant Instances are hosted on separate servers, it is essential to align the hosting configuration of the Tenant Instances with that of the Control Instance. The Tenant Instances should also be self-hosted if the Control Instance is self-hosted, similarly for Internet Information Services (IIS). Ensuring consistency in the hosting environment is essential in such scenarios. --- ## Example 1. Navigate to **Control Instance >****System >****Hosting and**click ADD INSTANCE. 2. From the **Add****Instance**window, copy the **Authentication****Key**into a text editor for later reference. 3. Under **Admin****Account**, PICK an [Account](https://documentation.decisions.com/v9/docs/adding-a-user-account) that will be used to login into the tenant Instance. No matter the account type, it will be automatically converted into an admin account for the tenant instance. Users can also assign accounts to the Tenant after completing the hosting of the Tenant. 4. Under the DATA category, provide the desired name in the **Instance****Name**field. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2022-02-07_14h41_44.png) 5. Configure the**Instance Base****URL**. Then, click ADD INSTANCE.****Users can also configure the**Internal Instance Base URL**for internal communication between the tenant and Control instances.****Instance Base URL Considerations For a **Self Hosted** installation, the default Instance URL is typically configured as **http://localhost:[Port Number of the Instance]**. Alternatively, the URL may be configured as **http://[IP Address of the machine]**. For an **IIS Installation**, the Instance URL should match the **BasePortalUrl**of the **Tenant**machine. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2022-02-07_14h56_441%20(1).png) 6. Verify that the newly added Instance is present in the **Hosting****Folder**. 7. From the machine location of the **Tenant****Instance**, [**download**](https://releases.decisions.com/releases/)the **v.8** **DecisionsServerInstaller.exe**. 8. Upon opening the Installer, select [**INSTALL**](https://documentation.decisions.com/v9/docs/installation-guide ). Then, select **Multi-Tenancy Server (Tenant) from the Select Installation Type screen**, then click **Next**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-30_11h40_27.png) 9. Proceed through the installation process as usual until the **Tenant****Server****Setup**window is reached. Then, provide the previously defined **Instance Name,** reference the **Control Instance URL** and the copied **Control****Instance****Authentication****Key**, and click **Next**. 10. Continue and finish the rest of the installation process, then launch the **Decisions****Portal**for the Tenant Instance. 11. From the **Login**window, log in to the defined Admin Account for the Tenant Instance, and select the proper Instance from the SELECT INSTANCE options. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2022-02-07_15h19_37.png ) 12. From the Decisions Studio of the Tenant, verify that the Hosting Folder can be Active status now states "**True**". Secured Key ErrorIf the **Tenant****Instance**is inaccessible after setup and the Instance's **Logs**display the following error: "Secured Key passed in is no more valid." Matching the **Timezone/Time**on each **Tenant**and the **Control**will fix the issue. ### Tenant Login Page Customization After Decisions has been installed on the **Tenant Instance**, the **Login Page** may be customized with a user-defined **Logo**. This is done via the following process. 1. From the **Control Instance**, navigate to the **Hosting****Folder**. Then, right-click the desired **Tenant Instance** and select **Edit Instance**. 2. Navigate to the LOGIN PAGE section and enable **Override Login Page Logo**. 3. Via **Drag File Here**, or **Choose a File**, add the desired image. Then, click OK. 4. Navigate to the **Tenant Instance** and verify that the **Login Page Logo** has been updated. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2022-05-17_13h49_10.png ) --- ## Assigning Accounts to the Tenants/Control Instance Once the tenant has been successfully hosted, you can proceed with assigning an account to a specific Tenant by following the steps below. If accounts are not created, admin users must [create the account/s](https://documentation.decisions.com/v9/docs/adding-a-user-account?highlight=Create%20Account ). 1. Log into the Control Instance. Navigate to the System > Hosting > Click on the Tenant Folder. The Instance Management page will open. 2. Clicking on **Add Instance Account** will open a Dialog Box to pick the account. The **Is Admin** property enables the account to be converted into an admin account, regardless of its account type in the Control Instance. 3. **Pick** the desired account to assign to the Tenant. --- For more information regarding **Multi-Tenancy**, see [Decisions Forum: Multi-Tenant](https://support.decisions.com/forum/forum23-multitenant.aspx ).