Skip to main content

The Vodia PBX will run as a service that includes a web server. To access it, use a web browser and enter the PBX's address. This is typically the name of the domain that was provided to you, e.g. The login screen typically looks like shown below.


There are three different levels for the login: system administrator, domain administrator and user.

User Login

In order to login as user, enter the username and password that was provided for the user account. The username typically does not contain a domain name; however if you are logging into a multi-tenant system that does not have DNS set up for the server, you might have to include the domain name in the username field like user@domain.

If you don't want to use the language used in the login screen, you may change it using the drop down. If you want to verify the password that you have entered, you can click on the eye icon next to the password field. If you check the remember button, the browser will store login information that will be used the next time that you login.

You can also log in with the email address that was assigned to your account. If you forgot your password, you can have the PBX send you instructions on how to reset your password.

If your system requires a second factor, you will have to select the factor that you would like to use (e.g. SMS or email). Enter the factor along with the extension number or email account and the password.

If the system administrator has listed the domain with, the user may login using the Google credentials. This eliminates the need to remember passwords for the PBX.

Domain Administrator

Like the system administrator, the domain administrator logs in with a username and a password. The PBX looks at the URL that was used for the login to determine what domain administrator account to use (domains may use the same name for domain administrators, e.g. admin@domain1, admin@domain2). After logging in, the domain administrator will be taken into the main screen for the domain.

Administrator Login

If you are logging in as administrator from the same device, you can use http://localhost to access the server. Otherwise you will have to determine the address of the server and use it to login, for example

  • Username : This is the administrator’s user name. By default, the user name is "admin".
  • Password : The password for the administrator. By default, there is no password; however, it is obviously strongly recommended that you set one after you login the first time.

There may be several system administrators per system. This makes is possible to work in a team without sharing passwords. The login as system administrator can be restricted by IP address, for example only to LAN addresses. This reduces the risk of a malicious login from a public IP address when the server is exposed to the public Internet.

Troubleshooting Login

There can be several reasons why the login does not work.

If there is no login screen, there must be a problem with the web server of the PBX.

  • You can use standard programs to find out what ports are in use on your system. In Linux you can typically use "sudo netstat -anp|grep :80" to figure out what ports are in use. Windows offers a similar program.
  • Make sure that the PBX can open port 80 and 443 on the PBX host. If you install the PBX on a standard CentOS or Windows server, those ports are often taken by standard web servers; make sure that those services are disabled or run on a different port. The PBX will try every minute to open the ports, so that you don't have to restart the service.
  • If you want the PBX to run on a different port, you can start the PBX manually with the command line option --http-port <port> and --https-port <port> (for example, ./pbxctrl --no-daemon --dir . --http-port 8080). This will start the service on a different port. After logging in, make sure that you change the ports also in the web interface so that the next automatic start will use those ports.

If your server displays a web page that looks broken, a customization effort might have gone wrong. In this case, try to login trough a simple non-styles web page with the name rawlogin.htm (e.g. http://localhost/rawlogin.htm). Then reset your customization and try again to login through the regular web interface login page.

Admin Password Reset

If you have forgotten your password, you are the system administrator and cannot ask anybody for the password, you can manually edit the pbx.xml file in the PBX working directory. Remove the setting "pw_pass" and restart the system. The password will be empty then. Don't remove the whole pbx.xml file, because this will corrupt the PBX database. Also make sure that you use an editor that can handle XML files, e.g. emacs or vi.