orchestrator
2021.10
false
UiPath logo, featuring letters U and I in white
OUT OF SUPPORT

Orchestrator User Guide

Last updated Oct 31, 2024

Managing tenants

A tenant is a unique and separate division or department within an organization. Each tenant has its own resources, separated from other tenants. In the standalone model, an organization is restricted to having a single tenant. As a result, a one-to-one relationship ensues between an organization and tenant.

Creating a Tenant

When creating a tenant, you also define the credentials for the administrator of the tenant.

  1. Log in to the Orchestrator host portal as a system administrator.

    The Tenants page is displayed.



  2. In the top right, click Add Tenant.

    The Provision Tenant dialog opens:



  3. Fill in the required fields Tenant Name,Password, and Confirm Password.
    Note: The username (admin) for the tenant administrator cannot be changed.
    Important: If you recently changed the settings, the password you define here may not be validated against the new settings because it takes around one hour for the changes to apply.
  4. (Optional) Fill in the First Name, Last Name, and Email Address fields.
  5. Click Provision.

    The tenant and tenant admin are created and the new tenant is displayed on the Tenants page.

    Note: The tenant administrator is a local user called admin. It is automatically created with the Administrator role when you add a new tenant, with the password and email address you provided in the Provision Tenant dialog.

Renaming a Tenant

Important:

Impact of changing the tenant name

Changing the name of any of your tenants greatly impacts your previous configurations:

  • Robots configured at the tenant level are disconnected. Users must reconnect their robots, entering the new URL.
  • The tenant URL previously bookmarked doesn't work anymore. Send your users the new URL.
  • Mobile Orchestrator users are disconnected. Send them the new tenant URL to connect again.
  1. Log in to the Orchestrator host portal as a system administrator.

    The Tenants page is displayed.

  2. Click docs image More Actions at the right end of the row and select docs image Rename tenant.

    The Edit Tenant dialog opens.

  3. Edit the name in the Tenant Name field.
  4. Click Update to apply the change.

    The tenant name is changed and the new name appears in the Tenants page.

Disabling or Enabling Tenants

Important: Remove licenses before disabling a tenant: If you intend to disable a tenant, remove the license allocation for the tenant prior to disabling it. Otherwise, the licenses are not returned to the license pool and you cannot use them for other tenants.

To disable or enable a tenant: In the Tenants page, click More Actions and select Disable or Enable:



To disable or enable multiple tenants: Select the checkboxes at the left of the tenants and then click Disable/Enable the selected tenants:



Enabling or Disabling Features

Until configured differently, all features are enabled by default for all tenants.

  1. Log in to the Orchestrator host portal as a system administrator.

    The Tenants page is displayed.

  2. Click docs image More Actions at the right end of the row and select Enable/Disable features.

    The Feature Flags window is displayed.

  3. Select the checkboxes for the features you want to enable on the tenant, or clear the ones you want to disable.
  4. Click Proceed to apply your changes.

Alternatively, select multiple tenants and click the Enable/Disable Features for Selected Tenants button to change the enabled features for multiple tenants at once.

Was this page helpful?

Support and Services
Get The Help You Need
UiPath Academy
Learning RPA - Automation Courses
UiPath Forum
UiPath Community Forum
Uipath Logo
Trust and Security
Terms of Use
Privacy Policy
Cookies Policy
© 2005-2025 UiPath. All rights reserved.