Date: Thu, 5 Aug 2021 17:17:13 -0700 (PDT) Message-ID: <> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_111766_310148120.1628209033928" ------=_Part_111766_310148120.1628209033928 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html Creating and Managing Tenants

Creating and Managing Tenants

The goal of multitenancy is to maximize resource sharing by allo= wing multiple users (tenants) to log in and use a single server/cluster at = the same time, in a tenant-isolated manner. That is, each user is given the= experience of using his/her own server, rather than a shared environment. = Multitenancy ensures optimal performance of the system's resources such as = memory and hardware and also secures each tenant's personal data.

You can register tenant domains using the Management Console of WSO2 pro= ducts.

About= tenants in the Identity Server

When multitenancy is enabled and a tenant becomes inactive for a long pe= riod of time, the tenant is unloaded from the server's memory. By default, = the time period is 30 minutes. Once the tenant sends a request again = it is considered active.

You can change the default time period allowed for tenant inactiveness b= y adding -Dtenant.idle.time=3D<time_in_minutes> Java pro= perty to the product's startup script ( file for= Linux and wso2server.bat for Windows) as shown below:

TS \
    -Dtenant.idle.time=3D30 \

In order to manage tenants, you ne= ed to be logged in as a super tenant.

Creating a tenant

To create a new tenant, take the f= ollowing steps:

  1. Use admin as the username and pas= sword to log in as a super tenant.
  2. On the Configure tab of the Management Console, click Add New T= enant.
  3. Enter the information about this = tenant as follows:
    • Domain - &n= bsp;The domain name for the organization, which should be a unique name (e.= g., This is used as a unique identifier for your domain. You= can use it to log into the admin console to be redirected to your specific= tenant. The domain is also used in URLs to distinguish one tenant from ano= ther. 
    • Usage plan for the tenant=  - The usage plan defines limitations (such as number of user= s, bandwidth, etc.) for the tenant. The Identity Server comes with a predef= ined list, and you can add your item and/or tailor to the existing items. F= or on-premises deployment, there is only one default plan, i.e., Demo.
      <= /span>
    • First Name = - First name of the tenant admin.
    • Last Name -= Last name of the tenant admin. 
    • Admin Username&n= bsp;- The username the tenant admin will use to log in. The username must a= lways end with the domain name (e.g.,
    • Email - The= email address of the admin.

Once you have added a tenant, you = can log out of the Identity Server and log back in using the newly created = tenant. Now, any settings you may do using that tenant will be unique to yo= ur tenant alone. You can now deploy, manage and test applications on t= his tenant, using the specific tenant URL.

Viewing tenants

To view existing tenants, on the Configure ta= b in the Identity Server Management Console, click View Tenant= s.

Related links

The following topics provide more information on various tenant related = aspects of the WSO2 Identity Server.