From Askozia Handbook
Jump to: navigation, search

In this chapter the system configuration is explained. This includes the general setup, storage disks, firmware updates, backup and restore, how to reset the factory defaults and how to reboot from the web interface.

How to get initial access to the web interface is explained in Getting Started with AskoziaPBX.

General Setup

The general setup is the first thing you should do after installing AskoziaPBX. It is of high priority to change the standard password of the web interface. Afterwards, you should make sure to configure your hostname, time zone, language and indication tones correctly.

Click Save to finish the configuration.


Setting the system name is important if two or more systems get connected to each other in order to identify them. Furthermore, you can leave notes for colleagues. The entered notes are also shown at the dashboard of the AskoziaPBX web interface.

General setup, system information


In Notifications, the email address of the system administrator needs to be entered in the Admin Email text field in order to receive system notifications, i.e. in case of a critical system status such as a failover during high availability.

Notification Network shows the MAC address of the network interface card (NIC) of the phone system. The IP address of this NIC is used for notification e-mails sent to the administrator by Askozia.

General setup, system notification settings


By default, the Web Interface Username is "admin", and the default Web Interface Password is "askozia". Of course, you can choose your own username. To avoid a security risk, you should change the standard password preferably the first time you log into the web interface. To do so, enter the new password twice in the respective text boxes.

The Statistic Username and Statistic Password are required for accessing a Wallboard. Statistic users can view the Wallboard but not change any configuration of the phone system.

The Wallboard is a website with real time statistics for each call queue. Both Queue modules and Wallboard require the Call Flow Editor.

To increase security further, you can activate HTTPS as Web Interface Protocol, and select an alternative Web Interface Port.

General setup, security options

Computer Telephony Integration (CTI)

These are the general settings for Askozia's CallControl CTI module.

Here, you can enter the CTI username and CTI password. Username and password are the same for all CTI users. By clicking on the link, the CTI can directly be opened in a new tab.

Match digits helps solving incoming phone numbers. Set how many digits of an incoming phone number are to be compared with the existing numbers in the phone book. It has to be taken into account that the incoming phone numbers are compared starting from the last digit, i.e. from the right to the left side.

It is also possible to set the CTI protocol to HTTPS and enter a custom CTI port for enhanced security. Set a port number if you want to overwrite the standard settings (28400 for HTTP/HTTPS).

When the CTI user is defined and you finished your custom settings, Call Control CTI is ready for action.

General setup, Call Control CTI

More information can be found under Getting started with the CTI in the menu bar at the left side.


If you would like to assign AskoziaPBX a domain name within your network, you need to enter it in the field Hostname. This enables you to make AskoziaPBX available from the outside world without sharing your IP address. Furthermore, you can use hostname instead of IP in provisioning files.


Regional Settings

The Web Interface Language allows you to choose from a variety of languages and to choose the Indication Tones used in your country. Indication Tones ensure that a telephone sounds like a telephone from that country (ringing, busy and error tones). You can also configure the Time Zone by selecting the location closest to you.

Furthermore, international prefix, national prefixes and country code can be entered, which are also relevant for matching incoming numbers for Computer Telephony Integration (CTI).

Regional settings

Time Synchronization

The system time shown at shown at Current Time is required for notifications and voicemail to provide the correct time stamps to recipients

To keep to system time up-to-date, you can chose Update Intervals between ten minutes and 24 hours. The default value of 4 hours is usually more than enough.

The synchronization is typically managed by a NTP Server belonging to the NTP (Network Time Protocol) pool. Some companies use their own time synchronization servers. If that applies to your company, enter the server address in the NTP Server text box.

Time synchronization

Voicemail Greeting

To upload your personal voicemail greeting, tick Activate custom Voicemail greeting. Then, click on Browse and add the path to the desired file. The file needs to be a .mp3, .wav or .ulaw file.

The uploaded greeting is used by all phones with activated voicemail. For more information, see Call Notifications and Voicemail sections for phones in the Accounts chapter.

Custom voicemail greeting


To upload your personal music-on-hold, tick Activate custom music-on-hold. Then, click on Browse and add the path to the desired file. The file needs to be a .mp3, .wav or .ulaw file.

Custom music-on-hold


Different ring tones can be uploaded for incoming and internal calls.

After ticking Activate custom internal ring tone, you can select a custom internal ring tone. Custom external ring tones can be selected after ticking Activate custom external ring tone. Click on Browse and add the path to the desired file for the chosen option.

Custom ring tone

The video below explains how the upload works despite the interface having changed in the mean time.


This is the license management system of AskoziaPBX. Depending on the software version you are using, you have a different number of license keys. If you are using additional software modules, you have an additional license key for each software module.

Active licenses

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.

Add licenses

Additionally to license keys for AskoziaPBX and software add-ons, maintenance licenses are added in case of a maintenance subscription. After adding a maintenance license, its expiration date shows for how much time it remains valid. Furthermore it shows if maintenance is only acquired for AskoziaPBX, or also +addons. A newly acquired maintenance license is valid for one year. Shortly before it expires, you will receive an e-mail. You can cancel the subscription by clicking on Cancel in that e-mail. Otherwise, the maintenance subscription will be prolonged automatically for another year.

When connected to the Internet, clicking on Askozia refresh.png validates the license keys once more and updates the expiration date of maintenance licenses. The validation is also done automatically on a regular base.

Maintenance license


In the storage menu additional devices can be added to store individual music-on-hold, voicemail greetings and other services.

Connect previously used device

If a device was used previously and is still connected to AskoziaPBX, it can be selected in the Previously Used Disks overview. By clicking on Askozia add.png, the device is mounted and moved to the Active Disks overview.

Previously used USB disks

Connect new device

Connect a device (e.g. a flash drive) to a USB port of your telephone system. Depending on the hardware platform used, a restart might be necessary. Click the Askozia add.png in the active disks overview to add a device.

USB disks overview

In the menu item Disk Device all recognized devices are listed. Choose the device you wish to format from the drop-down menu.

Before you click on Format, tick the box next to "I know, thanks for the warning." Further a file system has to be chosen.

Add USB storage

After formatting, an additional device can be seen in the device overview. As soon as the new device is recognized, you can upload files in the Media upload section of Services.

Click Askozia add.png to configure the device. Basic settings are Name, Mount Point and Disk Device. Choose a meaningful name.

USB storage, general settings

Additionally, you can choose different storage services: Media stores voice prompts, the night switch message and music on hold. Logs are the logging messages of Askozia. If the messages are stored on an external device, they are still available after a reboot. Fax Archive stores all incoming virtual faxes as PDF files. Mailbox stores voicemail on the external storage.

USB storage services

Click Save to finish the configuration.


Askozia automatically checks for new updates. Whenever an update for your software version is available, you'll find a notice. Simply click on Download and install.

If you like to update to a different version, please click on Manual update and select new firmware image (e.g. askozia-pbx-myplatform-myversion.img). The update process may take a couple of minutes. Your configuration won't be touched. However, it's strongly recommended to create a backup of both, your configuration and your data before updating.

Firmware update

Backup and Restore

AskoziaPBX allows to download its complete configuration as one single XML file, and to create a backup of the user data stored on the storage disk connected to the phone system as explained here.

Download Backup

For downloading and saving the complete configuration of the telephone system, click on Download configuration. With this XML file, the system's configuration can easily be restored to a previous working state.

You can also backup your USB storage. Click on Download storage backup to download and save it locally on your computer. Depending on the used space on your storage, this may take a little while as all files are compressed before being downloaded.

Download backup

Restore Backup

To restore the configuration of the phone system, an AskoziaPBX configuration file is required. Click on Browse to choose your configuration file (e.g. "config-askoziapbx.local-date-time.xml") and click Open. Once you see the path to your configuration file, click on Restore Configuration. Note, that the PBX will reboot after restoring the configuration.

To restore the files on your storage disk, click on Browse and select the backup file (e.g. "my_pbx_storage_backup_date.tar.gz") on your computer. Click on Open. With the desired file being selected, now click on Upload storage backup. Note, that the PBX will reboot after restoring the user data.

Restore backup

Automatic Configuration Backup

Starting from Askozia 5, a backup of the configuration will be saved each morning at 3am. This feature requires a storage disk to be connected, as described here. The backup respectively contains the configuration files of the previous 7 days and the previous 7 Sundays.

Restore or download automated configuration backup

In order to restore or download the desired configuration, it can be selected from the drop-down list.


The Recovery Mode helps to restore firmware or system configuration in case of malfunction. For this purpose, AskoziaPBX is booted from an external data storage device, such as a Live CD or Live USB drive. Each 19“ Telephony Server is shipped with a Recovery USB-Drive as from version V2 and the correct boot sequence is pre-configured. For older systems, or systems based on third-party hardware, the start sequence may need to be modified.

Web interface during recovery mode

Connect you boot medium, such as the recovery USB drive for 19" Telephony Servers, to the hardware you’re running AskoziaPBX on and start Askozia in Recovery Mode. If an Askozia firmware with a readable configuration is detected on your hardware during startup, the following recovery options become available.

How to do a factory reset and how to download a backup is identical to the corresponding sections listed below.

Restore Configuration

To restore the configuration of the phone system, an AskoziaPBX configuration file is required. Click on Browse to choose your configuration file (e.g. "config-askoziapbx.local-date-time.xml") and click Open. Once you see the path to your configuration file, click on Restore Configuration. Note, that the PBX will reboot after restoring the configuration.

Recovery mode, restore configuration


During a reinstallation of Askozia, the configuration of the PBX remains. For the reinstallation, the Askozia version stored on the Recovery USB drive is used and displayed in the web interface, as shown below for Askozia 5.0.

Recovery mode, reinstall AskoziaPBX


After selecting the target volume and clicking on Install, AskoziaPBX will be freshly installed. For the installation, the Askozia version stored on the Recovery USB drive is used and displayed in the web interface, as shown below for Askozia 5.0.

Recovery mode, install AskoziaPBX AskoziaPBX

Factory Defaults

In this menu you can reset your running telephone system to factory defaults.

AskoziaPBX factory reset

Once you click Yes the entire system configuration will be overwritten and the system will reboot. The IP address will be reset to use DHCP (Dynamic Host Configuration Protocol). The web interface username will reset to "admin" and the web interface password to "askozia".


In case you need to restart you telephone system you can do that within the web interface. Click on Reboot in the menu bar and confirm with Yes.

AskoziaPBX reboot request


If you finished configuring your telephone system for now, you can log out by clicking on Logout.