Brekeke PBX Wiki

  1. Brekeke PBX basic Info
    1. Brekeke PBX Quick start guide
    2. Brekeke PBX Quick start guide (Multi-Tenant)
    3. System requirement
    4. Hardware spec and performance (Brekeke PBX)
    5. How to check your software version
    6. Benefits & Features (Brekeke PBX)
    7. Brekeke PBX bundled SIP server
    8. Terminology
      1. Call
      2. Session
      3. Concurrent calls (Licensing)
    9. Interoperability - E1 Gateway (Brekeke PBX)
  2. Avoid Attacks
  3. Update & Upgrade
    1. Minor version update
    2. Update license
    3. Upgrade evaluation with new Product ID
    4. Upgrade Brekeke PBX v2 to v3
    5. Update Issues from v2.2.7.7 and earlier versions
    6. Update web server
  4. Configuration
    1. Installation
      1. New installation with a commercial license
      2. Install Brekeke PBX on 32 bit or 64 bit OS
      3. Install on Ubuntu
      4. Install Brekeke SIP Server and PBX on separate PCs
      5. Change SIP Server SIP Listening port
      6. Increase File Descriptor Limit on Linux
      7. Increase CentOS 6 Thread/Process Limit
      8. Increase IP_local_port_range TCP port range
      9. Increase Java memory used by Brekeke PBX
      10. Brekeke products with Mesh Network
      11. Reinstall Brekeke PBX in Linux
      12. Set port forwarding (Brekeke PBX)
      13. Update Java used by Brekeke PBX on Windows
      14. Uninstall Brekeke PBX
      15. Preparation before installation on Linux (Important)
      16. Disable SELinux
    2. Brekeke PBX default settings
      1. Max number of registered UAs
      2. Max number of concurrent calls
      3. Maximum voicemail messages
      4. Brekeke PBX Call Log
      5. Brekeke PBX parameters and syntax
      6. Brekeke PBX User Extensions and User Authentication Accounts
      7. Settings Directory List
      8. How Brekeke PBX counts calls?
      9. Ptime handled by Brekeke PBX
      10. RTP relay at Brekeke PBX
    3. Network Configuration
      1. Connecting Gateways with Brekeke PBX
      2. Setting for VPN
      3. Support NAT Traversal
      4. Using Brekeke PBX with a firewall
      5. Bind IP address for RTP relay
    4. Functions Configuration
      1. Performance optimization
      2. ARS
        1. ARS Target field
        2. Calls between two Brekeke PBX
        3. Connect to multiple ITSPs
        4. Decline non-numbered caller ID calls
        5. Default ARS Plug-ins for Notes
        6. Display caller name
        7. Distinguish outbound calls from calls between extensions
        8. Least Cost Routing (LCR) with Brekeke PBX
        9. Redirect call with 3xx response
        10. Setup for Connecting ITSP
        11. Call between two tenants
        12. Set the value of the Alert-Info header by ARS
      3. Auto Attendant
        1. Create Auto Attendant greeting message
        2. DTMF timeout
        3. Speed Dial
      4. BLF, SCA, and Presence
        1. Busy Lamp Field (BLF)
        2. Presence
        3. Shared Call Appearance (SCA)
          1. SCA Settings on the phone side
          2. SCA Settings on Brekeke PBX (3.6 ~)
            1. Old version - SCA Settings on Brekeke PBX (~v3.5)
      5. Codec
        1. Codec conversion & packetization interval
        2. Restrict Codecs used for a call
        3. Restrict outbound call codecs to G729
      6. Voicemail
        1. Are Messages deleted automatically?
        2. Automatically store voicemail to another directory
        3. Delete all voicemail messages at a time
        4. Different types of voicemail greetings
        5. Email notifications
        6. Forward voicemail message
        7. Retrieve voicemail messages
      7. Back up Brekeke PBX
      8. Call Pickup, Call Park
        1. Setting the Line Keys for Call Park
      9. Call Queue
      10. Call Waiting
      11. Confirm Call
      12. Fax Support
      13. Paging
      14. Queue settings at Call Hunting group
      15. Ring Group
      16. SRTP Support
      17. Switching Plan
        1. Switch plan in user extension
        2. Switch plan in schedule extension
        3. Change Switch Plan voice prompt
      18. Three-Way Calls
      19. Tutor Mode
      20. Video calls with Brekeke PBX
      21. Caller ID from analog (PSTN) phones
      22. Change busy forwarding destination according to response
      23. Change Music On Hold
      24. Change recorded audio files destination location
      25. Change RFC2833 Payload
      26. Replace display name
      27. Set RTP packet's TOS value
      28. TCP Support
      29. Microsoft OCS
      30. How to bypass Brekeke PBX
      31. How to create voice files (Fo IVR, Auto Attendant, Guidance) using your phone
      32. WebRTC
        1. Setting up Brekeke PBX to user WebRTC
      33. Web Phone
        1. How to Setup the bundled Web Phone
      34. Text to Speech
        1. Google Cloud Text to Speech
        2. IBM Watson Text to Speech
    5. Brekeke PBX Redundancy
      1. 1. Set up Brekeke PBX Auto Sync
      2. 2. Set up Mirroring at PBX bundled SIP Servers
      3. 3. Set up Heartbeat at Brekeke PBX
      4. 4. Test Brekeke PBX Redundancy
      5. 5. Resume to the State before Failover
    6. Remote Access of Brekeke Heartbeat
  5. Brekeke PAL option
    1. Brekeke PAL Basic Info
      1. What is Brekeke PAL?
      2. System Requirements
      3. Benefis & Features
      4. Price
    2. Configuration
      1. URL of Brekeke PAL Web Service
      2. Setting Up Development Environment
      3. Sample Program
        1. Setting up Sample Program
        2. Modify the Code
      4. Troubleshooting
        1. How to run two simultaneous PAL client programs on the same machine?
        2. Function calls has no response from PAL
        3. Function call produces an "Error: exception occurred..." message
        4. Sample Program is generating a COM ERROR
        5. Sample Program produces an error when creating the form
        6. Run PAL App on Windows 7
      5. Version History
  6. Add-ons
    1. Click-to-Call for Microsoft Outlook
  7. Troubleshooting
    1. Brekeke PBX License and Activation
    2. Starting Up
      1. Brekeke PBX stop running
      2. Cannot start Brekeke PBX, status Inactive
      3. Can't start Brekeke PBX in linux and the "UnsatisfiedLinkError" message is in a log.log
      4. Error - Failed to restart the SIP Server
      5. Error No.-200 in Brekeke PBX Admintool
      6. Got Exceptions when using GCJ
      7. Internet Explorer doesn't show the admin page
      8. Tomcat crashed when using Websocket
      9. Unable to install Brekeke PBX Service
    3. Log in
      1. Brekeke PBX user password
      2. Reset the default password of Brekeke PBX admintool
    4. Registering issue
      1. Registration fails from Brekeke PBX - ARS
        1. Authentication errors
        2. Expired
        3. 403 Forbidden
      2. Brekeke PBX upper registration
      3. Registration issue with UAs
    5. Call Transfer
      1. Transfer calls by Microsoft Windows Messenger
      2. Auto Attendant cannot forward calls
      3. Pressing "#9" does not invoke the Calll Hold state
      4. Call Hold not invoked by buttons
    6. Voicemail
      1. Cannot connect to the voicemail system
      2. Voicemail messages missing
      3. Not receive email notifications
      4. Message -"This message inbox is full", but it is not full.
      5. Change the default voicemail PIN of user extensions
    7. Trouble with Calling
      1. Call is not connected (no ringing tone)
        1. 404-Not Found, 484-Address Incomplete, 603-Decline
        2. 415-Unsupported Media Type, 488-Not Acceptable Here
        3. 482-Loop Detected, 483-Too Many Hops
        4. Other response code
      2. Disconnect suddenly
      3. Codecs and Protocols
      4. No INVITE packet from ITSP after restarting Brekeke PBX
      5. Disconnected when callee answers
      6. Brekeke PBX returns 486 for the inbound calls after updating
      7. Number of concurrent calls can not increse on Linux
      8. One-way call, and no voice at all
      9. Poor sound quality for uploaded sound files
  8. Known Bugs & Version History
    1. Known Bugs
    2. Version History

SCA Settings on the phone side

With the SCA setup and register phone SCA line as below, at Brekeke PBX Admitnool > [SIP Server Admin] > [Registered Clients], there will be registration records with prefix “line-“ or postfix “~line” corresponding to phones’ SCA line



If authentication for REGISTER and INVITE is set as ON at [SIP Server Admin] > [Configuration] > [SIP] page, the authentication users should be created as follows;


Brekeke v3.5 or older:

Create an authentication account for each phone’s sca line, and use prefix “line-” + phone_ID as authentication user ID set at both Brekeke server [User Authentication] account [user]and phone side.

Phone ID / SIP User:   “p360” (You have to create at [SIP SERVER] > [User Authentication])
SIP User for SCA line: “line-p360” (You have to create at [SIP SERVER] > [User Authentication])


Brekeke PBX v3.6 or later:

Create an authentication account for each phone’s sca line, and use phone_ID + “~line” as authentication user ID set at only phone side. You do not have to create authentication users for sca line like “phone_ID + ~line” at Brekeke server side.

Phone ID / SIP User:   “p360” (You have to create at [SIP SERVER] > [User Authentication])
SIP User for SCA line: “p360~line” (You do NOT have to create it at Server. System automatically generate it)

Settings on the phone side for SCA:


Panasonic KX-UT1xx


Panasonic KX-TGP550 T04


Polycom SoundPoint IP650 / 330

  • Prerequisite: None
  • Setup for SCA:

    1. Register a phone line as “line-6500” to Brekeke PBX server, and set “Type” as “Shared
    2. Set one or more in [Num Line Keys] field
    3. Save the settings and reboot the phone


Polycom SpectraLink 8440

  • Prerequisite: None
  • Setup for SCA:

    1. From Settings/Lines/Identification, register a line with “line-6500” in fields “Address”
      Num Line Keys: 2 or any number as you need
    2. From Settings/Lines/Server 1,
      Special Interop: standard
      Address: Brekeke PBX server IP
      Register: yes
    3. Save the settings and reboot the phone


Snom 360/7xx/820/870

  • Prerequisite: Firmware version 7 and up
  • Setup for SCA:

    1. Register a phone Identity as “line-360” to Brekeke PBX server as shared line,
      check [Identity]>[SIP]>[Shared Line] ON
      select [Identity]>[SIP]>[Server Type Support] Broadsoft
    2. Go to “Function Keys”, set any key from P1 to P12 as
      “line-360@PBX_IP ” “Shared Line” “<sip:line-360@PBX_IP;user=phone> “
    3. Reboot the phone.


Linksys SPA 962 / 941

  • Prerequisite: None
  • Setup for SCA:
    1. Register a phone extension as shared line,
      such as, at phone tab [Ext1], set User ID as “line-201” and select “shared” at “Share Line Appearance / Share Ext:”
    2. At the [Phone] tab, set any Line Key from 1 to 6 as
      Extension: shared extension number in step 2, here is 1
      Short Name: any name for the Line Key label
      Share Call Appearance: shared
    3. Reboot the phone
  • Note: 
    The following dial plan is needed, when using linksys SPA9xx linekey to pick up shared call, which is put on hold by other phones

    [Matching Patterns:]
    $request = ^INVITE
    $geturi(From) = (^sip:line-.+@.+$)
    To = !sip:.+@
    $pbx.inport = (.+)
    [Deploy Patterns:]
    To = %1
    $target =
    $transport = udp

Put the above dial plan rule on the top of others and click [Apply Rules] button.


Yes No
Suggest Edit