Getting Started with AskoziaPBX

From Askozia Handbook
Jump to: navigation, search

In this chapter we assume that either the installation of AskoziaPBX on your custom hardware was successful, or you've purchased a Telephony Server in Askozia's webshop. Either way, your telephone system should already be set up. The goal of this chapter is to do the general setup of AskoziaPBX in just a couple of minutes. This includes logging into the web interface, the basic configuration and first internal phone calls.

Finding Askozia's IP address

You need access to the web interface of AskoziaPBX to configure your PBX. To access the web interface with your web browser it is necessary to know the IP address of your telephone system. There are different options to determine the system's IP address.

  • If you have an analog or ISDN phone connected to your telephone system, dial 000047. The system's IP address will be read back to you. The breaks in the announcement correspond to the dots within the IP address. For example, "123 break 12 break 12 break 123" would correspond to the IP address . The announcement is repeated when not hanging up.
  • In case you do not have an analog or ISDN telephone available, disconnect your phone system from the network and restart it. After rebooting, connect the telephone system to your network again. The IP address of your telephone system is now "". Afterwards you can configure DHCP in the web interface. More about that in Connectivity.
  • Another way to find your system's IP address is the DHCP table of your router. Log into the web interface of your router. The IP address of your router can usually be found on the bottom side of the device.
  • The IP address can also be determined by accessing the console of AskoziaPBX as explained in the Console Access section.

With the IP address of your telephone system being known, you can now log into the web interface of AskoziaPBX. Follow the instructions in the Logging into the Web Interface section to set up AskoziaPBX and your phones, and make your first call.

Askozia's console

Askozia's console shows the IP address of the web interface and more console options. The following sections explain both the access options and console options. However, in order to get started with AskoziaPBX, only the access options are required.

Console access

Serial port

The console of a Desktop Telephony Server can be accessed through the serial port. The standard setting is 38400 8N1.

Starting with Askozia 4 for Generic PC, the serial port needs to be activated first. This is done through the Activate Serial Port checkbox in the Miscellaneous settings of the Advanced section and requires a restart afterwards. For Embedded image files, the console is accessible through the serial port by default.

To access Askozia's console of a Desktop Telephony server from a computer, a serial cable with RS232 interface needs to be connected to your Desktop Telephony Server or Business Appliance as well as your computer. Alternatively, a serial-to-USB adapter can be used. For Unix systems, the terminal application can be used. For Windows systems, PuTTY can be used as terminal emulator.

Serial port for Small Business Appliance
Serial port for Business Appliance


To access the console of a 19" Telephony Server, connect a keyboard to one of its USB ports and a monitor to either its HDMI or VGA port before the Telephony Server is started.

If no monitor is connected when starting the server, its graphics adapter is automatically disabled to save energy.

USB and video ports for Telephony Server v1

Console options

After starting AskoziaPBX, its console appears and displays the IP address of Askozia’s web interface. Furthermore, various console options are available which are explained below.

Askozia console options

1. Interfaces: assign network port: Here, the active LAN port of the phone system can be set.
2. Set up LAN IP address: A fixed IP address can be set, or DHCP be enabled. The default factory setting is DHCP.
3. Reset webGUI password: The user name for the system is set to "admin", and the password to "askozia".
4. Reset to factory defaults: The system is set back to factory settings.

5. Reboot system: Restarts the system.
6. Ping host: Pings a network address.
7. Asterisk Console: Opens Asterisk console.
8. Install or Recover: This options is only available if the PBX is running in Live/Recovery mode.
9. Console: Opens Linux console.
10. Disable firewall: Disabling the firewall is necessary if you are blocked after several failed login attempts.

Logging into the web interface

Open your web browser to log into the web interface of AskoziaPBX. Enter the IP address known from the Finding Askozia's IP Address section into the address field of your browser to access the front page of Askozia's web interface.

Landing page of the Askozia web interface

The Askozia landing page allows you to access either the AskoziaPBX admin interface or the Call Control CTI interface. This guide focuses on getting started with the AskoziaPBX admin interface to set up your phone system. For more information on Call Control CTI, visit Getting started with the CTI.

Click on Open admin interface and use the following data for logging in.

  • Username: admin
  • Password: askozia

Notification center

With Askozia 5, the notification center provides system status notification on top of the web interface. Here, administrators are informed about Reboot PBX and Restart web interface if required, for example to apply changes in the configuration.

Askozia Notification Center, overview

Furthermore, global error messages are listed that can not be assigned to explicit fields.

Askozia Notification Center, notifications


As from AskoziaPBX 4.0 the landing page of the Askozia admin interface provides a dashboard providing an overview of the most important features of performance of your phone system. Note that the dashboard is not required for the initial configuration of AskoziaPBX but is explained at this point for the sake of completeness. The following video introduces the dashboard of the Askozia web interface and explains its single widgets.

The AskoziaPBX admin interface, dashboard

The single widgets can be rearranged by drag and drop. Summarized, the dashboard displays the following information.

  • platform and software version: a click reveals the systems's uptime, license information and notes that may have been left by other administrators; notes can be left in the Information section of the System chapter
  • CPU: displays the average CPU load; a click reveals CPU information such as type, number of cores and capacity
  • memory: displays the occupied memory space; a click reveals the maximum memory capacity
  • storage disk: displays the occupied storage space; a click reveals the maximum storage capacity
  • telephony services: displays whether your SIP trunks, analog and ISDN lines work properly
  • phones on call: displays how many phone calls are currently taking place; a click reveals which extensions are in use
  • wallboard: every wallboard receives its own widget, displaying how many callers are currently waiting in the corresponding queue; a click additionally displays agents being online and agents currently answering a call; more information can be found in the Queue and Wallboard sections of the Modules chapter for the Call Flow Editor
  • nightswitch: displays whether the nightswitch is activated or not; a click allows you to turn it on or off; more information can be found in the Night Switch and Holiday Switch section of the Dialplan chapter
  • secure calling: displays whether secure calling is activated or not, which enables encrypted communication; more information can be found in the Secure Calling section of the Connectivity chapter
  • firewall: displays whether the integrated firewall is activated or not; a click leads to the firewall settings; more information can be found in the Firewall and Fail2Ban section of the Connectivity chapter
  • fail2ban: displays whether fail2ban is activated or not, which provides protection against password guessing and brute-force hacking attacks; a click leads to the firewall and fail2ban settings; more information can be found in the Firewall and Fail2Ban section of the Connectivity chapter

General setup

Activating licenses

When accessing the web interface of AskoziaPBX for the first time, the first step is to enter the license keys for AskoziaPBX, its software add-ons and maintenance and support packages as far as purchased. To access the license interface, click on System and subsequently on Licenses.

In the Licenses menu, click on Askozia add licenses eng.png to open the Activation Key text field and add one or more license keys. Multiple license keys can be entered or pasted into the Activation Key text field at the same time. AskoziaPBX automatically separates the keys and activates the licenses. Click on Save to activate the license keys.

Add licenses

After saving the license keys, they are listed in the Active Licenses overview.

Active licenses

Setting a password

After activating the license keys, click on System and General Setup to change the password in the Security Settings for logging into the web interface.

Username and password for web GUI login

Setting GUI language and time zone

By default, the language of the web interface is set to English. The webGUI language can be changed by clicking on System and General Setup and going to the Regional Settings.

Additionally, you need to set the time zone in order to have the correct system time. If the time zone is not set correctly, call notifications and voicemail contain the wrong time stamp which might lead to confusion. Furthermore, features such as the Nightswitch would not work as expected.

Regional settings

Click Save to finish the configuration and save your settings.

More information about the General Setup are given in System.

Setting up phones

In AskoziaPBX, each telephone has its own account. To add a phone account, click on Accounts and subsequently on Devices.

For analog phones, an analog phone account needs to be created where the port needs to be defined that is used to address the phone. For ISDN phones, a multiple subscriber number (MSN) needs to be configured at the phone itself.

VoIP telephones (SIP and IAX) require some configuration. However, AskoziaPBX offers provisioning templates for auto-provisioning of all supported SIP phones listed in the Supported Hardware chapter.

To add a SIP telephone, click on VoIP/SIP Phone.

Add a phone

Assign a Number, Caller ID and Language. The Ring Length is important for notifications and voicemail. This is further explained in Services.

General settings for SIP phones

SIP telephones require a password to register with AskoziaPBX. AskoziaPBX automatically generates a password for every telephone account. You can copy the password and use it for the configuration of your SIP phone. It is important that the passwords for telephone and telephone account match.

Password for SIP phone

Click Save to finish the configuration.

SIP phones overview

A more detailed configuration can be performed for every telephone type as explained in the Accounts chapter.

Determining a phone's extension

To determine the extension of a phone dial 000063. The extension will be read back to you.

The first call

If you have more than one telephone connected to your telephone system you can already make internal phone calls.

Congratulations, you have completed the general setup of AskoziaPBX. All further configuration can as well be performed via the web interface. In the next chapter all aspects of the basic system configuration are explained. If you do not want to wait any longer to make external phone calls, continue directly with providers.