Unified Communications System

The term “software multitenancy” refers to a software architecture in which a single instance of software runs on a server and serves multiple tenants. A tenant is a group of users who share a common access with specific privileges to the software instance. With a multitenant architecture, a software application is designed to provide every tenant a dedicated share of the instance – including its data, configuration, user management, tenant individual functionality and non-functional properties.

As of version 2.2 of VitalPBX, the Multitenant module is added with which, for free, you can have the main Tenant plus an additional one to test all the functions.

VitalPBX - Tenants


In this tab you will set the information about Tenants.

  • Name: a unique name for this tenant. This name will be used to create folders, linking cdr info, etc.
  • Description: short Description to identify this tenant.
  • Prefix: allows you to define a prefix to be used for extensions devices and others. If left blank an automatic prefix will be used.
  • Enabled: it allows you to enable/disable a tenant. If the tenant is disabled, the users who belongs to it will not be able to login to it nor perform any action.

Tenant Administrator

  • Assign to Existing User: if checked, instead of create a new user for the tenant, you may assign it a existing one.
  • Admin Email: the email address of the user who will manage this Tenant.
  • Admin Password: password to authenticate the default admin user of this tenant.
  • Full Name: administrator’s full name, if not defined, the tenant description will be used instead.
  • Profile: role profile for the administrator of this tenant. Be careful not to assign a too permissive role, which may affect other tenants.
  • Startup Dialog: which dialog to be displayed when loging into the system.


  • Extension: it allows you to define the maximum number of extensions for this tenant.
  • Trunks: it allows you to define the maximum number of trunks for this tenant.
  • Queues: it allows you to define the maximum number of queues for this tenant.
  • IVRs: it allows you to define the maximum number of ivrs for this tenant.
  • Conferences: it allows you to define the maximum number of conferences for this tenant.
  • Parking Lots: it allows you to define the maximum number of parking lots for this tenant.
  • Allow Tenant Trunks: it allows you to define which tenants could be used as tenant trunks.
  • Allow Recordings: it allows you to define if this tenant will be able to record or not calls.

Recordings Maintenance Settings

  • Clear Oldest Recordings: allows you to defined the maximum number of days that recordings should be retained. The recordings with more age than the days defined here will be deleted.
  • Schedule: it allows you to define the schedule in which the maintenance of the PBX will be executed (Conversion of Recordings, cleaning of Recordings and CDR, etc). If no schedule is selected, all the maintenance options will be disabled.
  • Convert Recordings: Enabled/Disable call recordings conversion to MP3.