# Tenants
Each Company will have at least one Tenant, up to three total. A Tenant is the instance of your Adaptiva Cloud product. After setting up and connecting a Tenant, an Admin can download client installers, view and interact with real-time dashboards, create workflows, etc.
Create a new Tenant within the Company you created, either under **My Tenants** on the **OneSite Cloud Portal Home** page or the **Tenants** tab of the **Company** page.
## Create a Tenant
1. Select **+ New Tenant** on the **Tenants** tab on the **Company** page.
2. Enter the desired **Name** and **Description** in the respective fields under **General Settings** on the **Create Company Tenant Configuration** dialog.
3. Enter the desired **Subdomain** in the respective field. For example, `cloudpatch` creates the URL `cloudpatch-company.adaptiva.cloud`.
The system combines the Tenant subdomain with the Company subdomain to create the Tenant portal URL. The subdomain must follow specific requirements:
* Starts with a letter
* Lowercase alphanumeric
* Between 1-30 characters
4. Configure the **Creation Settings** using the following steps:
a. Select **Browse** next to **Initial Administrators**.
b. Select the desired **Administrator** from the **All Administrators** list.
c. Select **OK** to return to the **Create Company Tenant Configuration** dialog.
The administrator appears in the **Initial Administrators** list under **Creation Settings**.
d. (Optional) Enter a product license key into the **Initial License** field, and then select **+Save License Key** to add it to the Tenant. Add additional license keys, as necessary.
5. Select the desired region from the **Tenant Region** dropdown list under **Regioning**.
6. Configure the settings under **Scheduling Settings**:
a. Set the Maintenance Schedule for when the Tenant may be taken offline for maintenance. A one-hour window is assigned to your Tenant. Set the schedule using the following steps:
1. Select the day from the dropdown menu.
2. Select , and then select the desired time from the dialog.
3. Select the desired time zone from the dropdown menu.
b. Set the Backup Schedule time using the following steps:
1. Select , and then select the desired time from the dialog.
2. Select the desired time zone from the dropdown menu.
{% hint style="info" %}
The time you select for the Maintenance Schedule must fall between 9:00 AM - 9:00 PM US/Pacific time.
{% endhint %}
1. Select **Save** at the upper-left of the **Create Company Tenant Configuration** dialog.
The system may take several minutes to create your Tenant. When it is ready, you will receive an email from `twilio@adaptiva.com` confirming that the Tenant is available for use.
### Provisioning States
A Tenant appears under **My Tenants** with a Provisioning State icon. The following icons indicate the provisioning state of the Tenant:
* **Setup**: This icon () indicates that the system is setting up the new Tenant.
* **Active**: This icon ( ) indicates that the Tenant is active.
* **Disabled**: This icon () indicates that the Tenant is disabled.
## Manage your Tenant
Once you have created your Tenant, you can manage your Tenant settings from the Cloud Portal at any time.
1. Click **Manage** under your Tenant from the Home page on the Cloud Portal.
2. This will display your configurations made during creating a new Tenant. You can alter the following settings:
* Tenant Name
* Tenant Description
* Tenant Region
* Scheduling Settings
Super Administrators and Administrators can be managed in their respective tabs. You can add or remove users from either user type. For more information about user roles, please see our [Administrator Roles](/cloud/user-management/roles-responsibilities.md) page.
Additionally, you can download cross-platform Tenant client files and **Reset Client Activation Tokens**.
{% hint style="danger" %}
Resetting Client Activation Tokens will require ALL existing clients to redownload their client files.
{% endhint %}
## Connect to Your Tenant
Connect to your Tenant using the following steps:
1. Select  **Connect** on the **Company** page. You can also connect via the **Tenant** page at the upper-right corner, or on the main landing page when first signing in.
2. The **Adaptiva Admin Portal** will appear indicating your Tenant has successfully been connected. For further instructions on how to
{% hint style="warning" %}
After seven days of inactivity, you will receive an email from `twilio@adaptiva.com` notifying you of the inactivity. The Tenant will be disabled after being inactive for 30 days. At 90 days of inactivity, the Tenant is automatically deleted.
Open a ticket with [Adaptiva Support](https://github.com/AdaptivaDocs/docs/blob/main/cloud/support.adaptiva.com) for help with enabling the Tenant before it is deleted.
{% endhint %}
## Downloading the Adaptiva Client
Download the installation file () next to the desired OS option under:
**Tenant Client Downloads**. For more information on downloading and installing the Adaptiva Client for Linux, macOS, or Windows, see [SaaS Client Installation](https://docs.adaptiva.com/platform-install/client-install-and-uninstall/client-install/client-install-saas).
## My Tenants Section
Create, connect, manage, or delete tenants under **My Tenants** on the **Home** page, depending on the permissions assigned to you.
To manage a tenant, select **Manage** on the appropriate tenant.
### Scheduling Settings
Set the maintenance schedule for upgrading the Tenant, and the backup schedule under **Scheduling Settings** on the **Tenant** page.
### Reset the Client Authorization Token
1. Select **Reset Client Authorization Token** under **Tenant Client Downloads** on the **Tenants** page.
The new token appears on the **Reset Client Authorization Token** dialog:
2. (Optional) Select **Regenerate Token** to create a different token or enter your own token.
3. The token must be an alphanumeric string between 8-64 characters.
4. Select **OK** to return to the **Tenant** page.
{% hint style="warning" %}
Client authorization tokens are now replaced in the client installers. Existing clients will continue working. However, new installations require the updated installer to facilitate handshaking with the Tenant server. Download new installers after changing the Authorization token and delete any previously downloaded files.
{% endhint %}
### Delete a Tenant
1. Select  **Delete Tenant** on the upper-right of the **Tenant** page or on the **Home** page under **My Tenants**.
The **Schedule deletion for <...>** dialog appears:
2. (Optional) Select the Export Logs button in the top right of the Schedule deletion window. This will automatically download a .log file to your Downloads folder by default.
3. Select **OK** to schedule the deletion of the Tenant.
Tenants will automatically be deleted 90 days after the request. You will receive an email from `twilio@adaptiva.com` confirming that the Tenant was deleted.
#### Cancel Tenant Deletion
Select  **Cancel Deletion Request** on the upper-right of the **Tenants** page to cancel the Tenant deletion request or from the **My Tenants** section of the **Home** page.
You will receive an email from `twilio@adaptiva.com` acknowledging the cancellation of the Tenant deletion request.
## Update Tenants to latest version
By default, updates are sent from Adaptiva automatically to the your Cloud Portal Tenants. Your Tenant will update to the latest version during your defined Maintenance Schedule. If you are in an active session, you will see a banner request to refresh the page so you can view the latest released version. This will also automatically trigger the new version to be deployed to your clients.
{% hint style="info" %}
If your Client Upgrade settings are set to **Deploy Immediately**, this will be reset to the default **Deploy in scheduled wave (default)** of 7 days.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.adaptiva.com/cloud/configuration/create-tenant.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.