Skip to end of metadata
Go to start of metadata

Jun 20, 2019 08:02

PBX Licensing and Activation

This document helps you understand Wildix licensing and explains how to activate a Wildix Per User PBX (Hardware, Virtual, Cloud).

Date: June 2018

Updated: June 2019


Understanding Licensing

Wildix currently offers Per User licensing. It means that you can add as many users of each profile as you need and add more users whenever you need. You pay per user / per period of time. 

Here are the steps to activate a Per User PBX:

  1. Choose the platform: Hardware, Virtual, Cloud
  2. Choose the recurrent payment cycle: Monthly / Yearly / 5 years / Lifetime (lifetime is not available for Cloud)
  3. Choose the number of users of each Profile: Basic / Essential / Business / Premium

Note: you first select the period of time and then the number of users, this means you cannot select different recurrent payment periods for different types of user profiles, e.g. if the recurrent period is 1 year, it means the users of all types (Basic, Business, Premium) are added for 1 year. You can increase the number of users any time (add more users of any type).

Example: you need 10 users with basic phone services, 30 users with access to Collaboration and only 5 users with access to CDR-View. You activate 10 PBX-BASIC users, 30 UC-ESSENTIAL users and 2 UC-PREMIUM users. At any moment, you can add more users of any type.

Details on each user profile:

Per User licensing is available for any PBX type:

  • Hardware

  • Virtual

  • Cloud

Activation of PBX | Cloud, Virtual, Hardware


  • For Hardware PBX you need first to purchase a Hardware PBX in WMP -> Cart (code: WPBX-HW):

Step 1. Add a new Per User PBX on WMP 

Proceed as follows:

  • Connect to WMP using your credentials

  • You are now under Customers tab; to create a new PBX, you first need to add a customer (if it does not exist yet); click Add:

  • Create a new customer (company): fill in the fields and click Save:

  • You need to create at least one contact: fill in the fields and click Add (License field is optional):

  • Now you can proceed with adding a new PBX: go to PBXs tab:

  • You are now under PBXs tab, click + to add a new PBX:

  • Fill in the fields:

    • Model: select WPBX-CLOUD for Cloud / WPBX-VM/HW for Virtual or Hardware

    • Region (only for Cloud PBX): select the datacenter region

    • Name: PBX domain name by which your PBX is accessible via the browser; in the example provided below, the PBX can be accessed by URL

    • Expire: select the recurring billing period: monthly / yearly / lifetime (lifetime is not available for Cloud PBX)

    • PBX-BASIC / UC-Essential / UC-Business / UC-Premium: add the number of users of each profile (more about each profile:

    • Storage size (only for Cloud PBX): increase Cloud instance storage size . Refer to this chapter for more details

  • Click Add and then Ok to confirm the subscription fee; your PBX has been added:

Note: after the PBX has been added, you can see its Software Serial (SW Serial):

You can use SW Serial to activate new HW PBX in case of RMA or you can replace HW with VM PBX and vice versa. In this case new PBX will take Name, Licenses and attached Devices of the SW serial.

Please note, next activation of HW PBX will automatically convert HW Serial to SW Serial preserving its Name, Licenses and attached Devices. So HW Serial will disappear from portal and new SW Serial will appear instead.

Step 2. Activate PBX from WMS 

For Virtual PBX: before proceeding, follow the guide to deploy PBX image:

For Cloud PBX: wait for approximately 3 minutes before proceeding. Your PBX will be activated. 

Proceed as follows:

  • Connect to PBX via HTTPS to access WMS using credentials admin : wildix

  • Change admin user password:

    • Select admin user and click Set passwords

    • Generate or create a new WEB password, click Ok

  • Upgrade WMS to the latest stable release

    • go to WMS Settings -> Tools and utilities -> Upgrade

    • In case there is a new version available, click Perform Upgrade 

  • Copy PBX key from WMP:

    Only for Virtual and Hardware PBXs. Cloud PBXs are activated automatically (wait for approximately 3 minutes after completing Step 1).

    • go to Customers tab, select your company, then select the PBX that you have created (Step 1)

    • click the Copy icon (Copy PBX key to clipboard):

  • Insert the PBX key on WMS side:

    • open WMS Settings -> Tools and utilities -> Activation / Licenses

    • Paste the PBX key copied on the previous step into the field User Mode and click Activate

Your PBX is now activated:

Enable SSH port on Cloud PBXs (optional) 

Direct access to SSH port on Cloud PBXs is blocked for security reasons. Now it’s up to you to temporarily enable/ disable SSH port 2222 via WMP:

  • Go to WMP -> PBX per user
  • Select your company and your customer
  • Click Options button (Three dots) and select Edit
  • Click Advanced features
  • Select Enable SSH option

If there is a need to block the port, it can be deactivated via Disable SSH option.

Share Per User Licenses between PBXs over WMS Network

It is possible to share licenses over other PBXs in the WMS Network. Normally this scenario is used for Failover configuration. In this scenario you add UC profiles (users) only on Server PBX and then you can share the licenses enabled on Server PBX with Client PBX(s). 

Prerequisites for this scenario:

  • The PBXs must belong to the same customer

  • WMS Network must be enabled between the PBXs

  • Cloud PBX can only be the Server PBX

  • All PBXs must be of Per User type

  • There must be no licenses enabled on the Client PBX

To enable WMS Network license sharing, proceed as follows:

  • Go to WMP -> Customers

  • Select your company and customer

  • Select the Client PBX -> click Edit

  • Select WMS Network License and select the Server PBX from the drop-down list

  • Click Save

Note: after you click Save, an automated email is sent to a corresponding Wildix Administration manager who must manually apply this change; please mind that the WMS Network License sharing is activated during working hours.

Periodic License Check

As stated here:, all Virtual and Hardware systems update their license information daily connecting via port 443 to:

  • – WMS version lower than 3.86

  • – starting from WMS version 3.86

(this doesn’t apply to Cloud systems)

If connection to the license server is not available, a Hardware / Virtual Per User PBX will continue working for 14 days only. After which the PBX will support only one call for emergency purposes.

In case any of your customer's PBXs are not able to renew its license, you are notified via email containing the following information:

  • the name of the customer (company)
  • PBX serial and model
  • how many days have passed since the PBX couldn't renew the license

In case this PBX should continue working, all you need to do is to make sure the PBX is connected to the Internet again, and in this way it is able to renew its licenses.

Increase storage on Cloud PBX

To perform it, proceed as follows:

  • Select the customer and choose the Cloud PBX (or add a new one)
  • Click Options button (Three dots) and select Edit

  • Increase the storage size: 1 license=10 GB

  • Confirm the operation by clicking Yes

Note: The change will be applied at 1AM.

Important: After you have increased the storage size, it will not be possible to decrease it.

Increase / decrease the amount of Per User accounts

It is possible to increase/ decrease the number of accounts any time.       

  • Go to WMP -> Customers
  • Select your company and customer

  • Select the PBX -> click Edit

  • Add/ remove the number of users of a required profile
  • Click Save and Ok to confirm the operation

Limitation: Lifetime licenses cannot be decreased.  The operation of decreasing a number of accounts  must be approved by Wildix: in this case a request is sent to the Wildix Manager for a review. Partner is notified via email after the request has been approved.

Video Tutorials

Activation of Per User PBX (Hardware, Virtual)

Video tutorial - Starting from 2:07 (2m07s)


WMP Intro Video

Video tutorial:

Not finding the help you need?
Join the Facebook group to ask a question!

  • No labels