# Tenant management

The **Tenant** section of the admin panel lets you **customize** the global settings of your [PaaS platform.](/en/paas.md) This section centralizes all the configurations that define the behavior, limits, and features of your AIsuru instance.

### **Section overview**

Tenant configuration is organized into several categories that define:

* **General information** about the platform;
* **Usage limits** for Agents, users, and resources;
* **Chat history** and how many days to retain it;
* **Audio configuration**
* **SMTP configuration** at the tenant level
* **Features** enabled for users;
* **Customization** of the user experience.

### **General information**

* **URL**: main address of the platform (e.g. url.example.com);
* **Name**: name of your PaaS instance;
* **Logo URL**: address of the company logo image;
* **Admin email**: main administrator's email address *(editable)*;
* **Theme**: color scheme for the user interface;
* **Privacy policy URL**: link to the privacy policy *(editable)*;
* **Perplexity API Key**: This key will be used by tenant users *(editable)*;
* **Aliases**: alternative domains separated by commas (e.g. url1.example.com, url2.example.com).

### **Agent limits**

* **Max Agents per admin**: maximum number of Agents admins can create;
* **Max Agents per user**: maximum number of Agents each user can create *(editable)*;
* **Max total Agents**: overall limit on Agents across the platform.

### **User count limits**

* **Max admins**: maximum number of platform administrators;
* **Max users**: maximum total number of users who can register.

### **Session limits**

* **Disable registration**: control to block new sign-ups;
* **Max free sessions**: total limit of free sessions on the platform;
* **Max free sessions per user**: limit of free sessions per user *(editable)*;
* **Non-free session cost**: rate for paid sessions.

### **AI message limits (completions)**

* **Max completions**: total limit of AI responses the platform can generate;
* **Max completions per user**: limit of AI responses per user *(editable)*.

### **Document upload limits**

* **Max import size**: global limit for document imports;
* **Max import size per user**: import limit per user *(editable)*.

### Chat history: days to retain

Specify how many days you want to keep conversations for.

**Warning:** once the retention period ends, conversations will be automatically deleted. This is irreversible and the deleted data cannot be recovered.

### Audio configuration (TTS and STT)

You can choose to change the provider used for voice services. The available options are:

* Azure (AI Speech): already used by default on the platform;
* OpenAI: will use the whisper-1 model for STT and tts-1 for TTS.

After selecting the **Speech provider**, continue by entering the API key in the **Speech API Key** field.

**Note:** make sure you're using an active API key with the necessary permissions for TTS and STT services.

### **SMTP configuration**

Fill in the following fields:

* SMTP Server: the address of the SMTP server;
* SMTP Port: the port number used;
* SMTP Username: the username for authentication;
* SMTP Password: the authentication password;
* Socket Security: select the protocol from the dropdown menu;
* Sender Email: the email address that will appear as the sender;
* Sender Name: the name that will appear as the sender.

To see configuration examples, go to the documentation section on [AIsuru's email sending function](/en/advanced-features/integrations/functions/aisuru-functions.md).

### **Features**

* **Paying**: this option is normally enabled;
* **Billing delegation**: this option is normally disabled;
* **Users can create Agents**: permission for non-admin tenant users to create Agents *(editable)*;
* **Users can edit the Memori chain**: enables the ability to use [Expert Groups](/en/extensions/expert-group.md) in the tenant;
* **Enable badges**: lets your users earn Open Badges;
* **Enable virtual spaces**: access to and management of 3D environments;
* **Enable Deep Thinking**: enables the ability to use Deep Thinking on the tenant;
* **Enable DCM integration**: lets your agents provide Open Badges through contents;

### **Conclusion**

To save your changes, click the "Confirm" button at the bottom. Changes take effect immediately.


---

# 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.aisuru.com/en/paas/admin-panel/tenant-management.md?ask=<question>
```

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.
