Skip to main content

The Vodia PBX uses the notion of a tenant to describe a group of users that are able to distribute and transfer calls within that group, see (with restrictions) the status of other users, reassign mailbox messages and generally collaborate on voice calls. They can also access the same address book and share features, such as call monitoring and call park/pickup.

Tenants have a DNS address under which those users typically register their phones and log into their web front-end. A tenant on the Vodia PBX is similar to an email tenant. Typically one company has one tenant on the Vodia PBX.

Each tenant has one or more names. One name is the primary name which is used when the PBX wants to represent the tenant. The other names are alias names that serve when the PBX needs to match incoming requests to a tenant on the system. The DNS name localhost has a special meaning in the PBX; it matches any incoming name, so that the PBX can accept for example traffic that is directed at the IP address of the PBX.

The Vodia PBX telephone system generally supports multiple tenants on each instance, even if the license was issued only for one tenant. By default, the PBX creates a tenant with the DNS name localhost. This tenant can be renamed or deleted if there is no need to match incoming request to a tenant that would otherwise not be mapped to a tenant.

Creating a Tenant

In the admin mode, click on List to show the list of tenants on your PBX, as well as the section to create a new tenant as shown.

Create new tenant dialog

  • Tenants should have a descriptive name. The Name of this tenant can be any text, including spaces and UTF-8 characters. Typically is has 10-40 characters so that the formatting will work well across sites.
  • Tenants may have multiple DNS addresses. The Primary DNS address will be used when the PBX sends requests from this tenant.
  • Other DNS addresses are additional addresses that can be used to locate the tenant on the server. Use spaces between the alias names.
  • You should use a Country code to tell the system what context to use for phone numbers.
  • If you have a backup for a tenant as a .tar file, you may use it in the Create from file as a template to create the new tenant.
  • Press Create to create the new tenant.

It will appear in the list of tenants above, which you can click to enter.

Editing a tenant

There are two ways to edit the content of a tenant. The first method is to switch into the tenant context and edit the accounts, address book and all the other information in tenant mode. This is done by clicking on the tenant name in the tenant view web page.

Certain settings can only be edited by the system administrator. Those settings include the name for the tenant, the DNS addresses, and also other billing-related settings, the maximum number of accounts that can be set up in the tenant, certain flags for example for voicemail transcription. In order to edit those features of the tenant, click on the edit button in the tenant row.

Deleting a tenant

In order to delete a tenant, click on the delete button. The system will prompt for a confirmation of this action and then remove all information stored inside that tenant from the system.

Tenant backup

The system administrator can download a .tar image of a tenant from the web interface of the system. This backup can be used to restore the tenant, but it can also be used to create a new tenant (use it as a template). This backup is hard to generate from the file system because of the structure of the data in the file system (in order to backup the whole system, it is easier to just copy the working directory of the PBX).

(System data)

The tentant backup does not contain information that is on system level. This could be for example the preferred transport layer for SIP or the default country code for the system. Also when restoring tenants that contain phone numbers that have a system scope (DID, ANI), global trunks or dial plans, or MAC addresses, they cannot be restored if they are already present on the system.

When generting a tenant backup, the size of the resulting file might exceed the limits set for the system. If that is the case, navigate to (AdministratorGeneralSystem and scroll down to Performance and increase the size fo the configuration backup file to a size that would be able to store your tenant data.

![Changing maximum file size](/doc/Screen Shot 2022-05-17 at 6.57.32 AM.png)

In order to perform a tenant backup, there is a download button in the row for the tenant. Clicking on that button will trigger a download of the tenant configuration data in .tar format.

Downloading a tenant

Restore your tenant

To restore a tenant, navigate to TenantsList and click on Create. In addition to the parameter for setting up an empty tenant, you need to select the backup file.

Cloning a tenant

Synchronize tenant settings

When you click on the synchronize button next to the download button, the system will attempt to synchronize the MAC addresses in that tenant with the redirection server for the phone vendors (if set up). It will also attempt to issue the ACME certificate for the DNS names of that tenant.