Overview of Domains

The Vodia PBX uses the notion of a domain 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. 

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

Each domain has one or more names. One name is the primary name which is used when the PBX wants to represent the domain. The other names are alias names that serve when the PBX needs to match incoming requests to a domain on the system. The 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 domains on each instance, even if the license was issued only for one domain. By default, the PBX creates a domain with the name localhost. This domain can be renamed or deleted if there is no need to match incoming request to a domain that would otherwise not be mapped to a domain.

Creating a Domain

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

  • Domains may have multiple names. The primary name will be used when the PBX sends requests from this domain.
  • Alias names are additional names that can be used to locate the domain on the server. Use spaces between the alias names.
  • If you have a domain backup as a .tar file, you may use it in the Create from file as a template to create the domain.
  • Press to create the new domain.

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

Editing a domain

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

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

Deleting a domain

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

Domain Backup

It's always important to make a backup of your domain configuration in case you need to re-build the PBX. 

Before performing a backup, Navigate to (Administrator --> General  --> System and scroll down to Performance -> increase the size fo the configuration backup file to 100MB.



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


The data can be used to restore the domain on the same system later, or another system. If there are references to system-wide resources like global trunks or global dial plans, those trunks or dial plans must be available on the system where the backup is loaded.

It is also possible to use this feature to create domain templates. When creating a new domain, those templates can contain a typical domain setup. This reduces the time to set up a new domain in multi-tenant environments. 

Domain backups can get large, especially when the domain contains a large number of mailbox messages and domain specific audio files. 

Restore your domain

To restore domain configuration, navigate to Domain list under the administrator and click on create. 

  • Primary name ( Name of your domain) 
  • Alias ( Can be localhost if it's single domian) 
  • Country Code  Ex. (617) 
  • Create from file ( Upload your domain.tar file.