Page tree
Skip to end of metadata
Go to start of metadata


OSS PBX End Point Manager is the community supported PBX Endpoint Manager for FreePBX.
The front end WebUI is hosted at:
The back end configurator is hosted at:
Pull Requests can be made to either of these and are encouraged.

This is not the same at the commercial EPM and It is NOT supported by FreePBX or Sangoma Technologies inc. If you are looking for a Commercially supported endpoint manager please look into the Commercial Endpoint Manager by Sangoma Technologies inc


See the Tutorial Video


We welcome community contributions to the WIKI for documentation. Please message James Finstrom To contribute information for the wiki.

For code and bug contributions you may fork the github repos  mentioned above and submit pull requests back to the projects.

Current open bugs

Key Summary T Created Updated Reporter Status

  • No labels



    There is a decent video tutorial located at Endpoint Manager Video Tutorial


    Edit: spelling and link name

  2. I have found the OSS End Point Manager itself to be generations old, and Polycom support hasn't been updated for a year and a half.  I would love to know if support will ever begin again for the module, as it certainly adds some value to the distro.  This does make a very good argument for purchasing the Schmooze commercial manager however, which also contributes to supporting the project.  I am going to begin using the commercial module on my next build.


  3. Has anybody added the grandstream 2160 ? 

    1. Patches always welcome

    2. Sorry I didn't see this sooner Christopher.  I have added support for the GXP2130, 2140, 2160, and 2200 to the Grandstream brand package.

      The James - How can I share this?  It's the complete Grandstream brand package with the additions above (.tgz).


      1. Hi Tededwards,

        Can you share with me the GXP items?  I've got some 2160's that this would be great for.

        1. Grandstream brand package sent 1/24/16 ................any problems with your 2160 provisioning krzykat?

          1. Nope - using the provisioning on the 2160 and its working like a charm.

          2. Can I get this updated package?  Does it have the profile for the gxp1625 as well?

  4. Their is no active development on this module from the FreePBX project. It has always been an outside module built and maintained by others and has very little development on new phones.

  5. Hi All,

    I have used the OSS endpoint manager with customer customisations now for many years for SNOM handsets.  I have implemented new devices, fields and features through the GUI, and sorted some of the 3xx & 7xx issues out.  In my opinion, the SNOM is above the Polycom in programming capability and real world implementation.  The Level 1 guy can quickly address programming requirements through different templates.  My sites all use dialplans correctly setup, arising colleagues comments oh that voip system works like a real phone system...  well drrr yes why shouldnt it.. Most work is customised per customer with drop down menu selections instead of data fields as have found less troublesome with the level 1 guys.

    To their credit, the Schmoozecom commercial module works great for a basic install and is where ALL installers/admins should start.  If it works as you need - fine, your set.  However its limited when you move into power programming mode when needing to use more of the complex XML programming on the snoms.

    Keen to implement the realtime XML via SIP programming of handsets that doesn't mean a device reboot in the future.  This is especially the case with the new D7 expansion unit is now out and add/moves/changes occur often in a large deployment.

    Would welcome some feedback on how to put this back to the community?

  6. For code and bug contributions you may fork the github repos  mentioned above and submit pull requests back to the projects.

  7. I've tested the Endpoint Manager from Schmooze, and OSS Endpoint Manager. For Polycom phones at least, I find OSS a lot better and easier to use.  The advanced template editing capabilities are also much better than the Endpoint Manager.  Keep up the great work people that are doing the OSS Endpoint Manager!

  8. Hi Guys!

    EPM commercial is only supported to Freepbx Distro. I use a mannually installed Freepbx... Will it works? I was almost buying when see this info...

    Trying OSS EPM... and Yealink W52 is not covered ... Any chance to have this model included? I tried to clone another Yealink... but W52 has "accounts" like lines, and other differences in the file estructure..


    1. Any FreePBX system with FreePBX 2.10 or greater, CentOS/RH/SL/EL 6.x and php 5.3 should work with most Commercial Modules

      Installation on CentOS and RHEL based systems

  9. I've switched our systems over to Commercial Endpoint Managers, and it works without any issues for Polycom Phones.  I would now recommend it over OSS Endpoint Manager since the commercial one is officially supported by Schmooze.

    A few notes about the commercial one:  I find the configuration and interface is not as nice as OSS.  Not as intuitive for configuration.  Another thing I liked about OSS was it shows the phone's online status, which is really helpful when you are trying to provision a phone remotely.

    1. Feel free to submit feature requests/improvements to our issue tracker

  10. The Grandstream GXP2130 support seems to be broken. FreePBX throws and exception when you attempt to make any changes to an extension. Hey tededwards, I see you added the Grandstream support. The error seems to be in a php module provided in the files.


    1. I did not add the GXP2130 support to the distributed module (github).  I do, however, have a Grandstream brand package that can be imported (Advanced Settings) that adds support for the 2130, 2140, 2160 and 2200.  I know it works as I use it regularly.  Let me know if you  want it, I'll email it to you.

      1. There's already some kind of Grandstream support inclulded in OSS. When I try to access the 2130 support I get an exception in:


        With the error:

        preg_match() expects parameter 2 to be string, array given

        The code block shown is:

            function reboot() {
                if (($this->engine == "asterisk") AND ($this->system == "unix")) {
                    exec($this->engine_location . " -rx 'sip show peers like " . $this->settings['line'][0]['username'] . "'",
                    if (preg_match("/\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/", $output, $matches)) {
                        $ip = $matches[0];
                        $pass = (isset($this->options['admin_pass']) ? $this->options['admin_pass'] : 'admin');

         If there is something else to be imported, sure, send it to me.



        1. Kirk,

          I'm not seeing your error with the 5.211.65-21 disto and OSS 2.11.12 with the included Grandstream brand package GXP2130.  What are you running?

          I can sure send you my brand package but not sure that will solve your problem.

          1. I don't know what you mean by "distro" but I'm running FreePBX 13.0.73 through RasPBX. The file image of RasPBX I used was raspbx-25-01-2016.img. The module admin screen says I am using OSS Endpoint Manager I installed it from a tarball on GitHub.

            1. I meant the Schmooze distro......but you're running a Raspberry Pi.  Try upgrading to the latest - (  - remove array by reference, - Fix missing files issues.).  I don't think your problem is with the Grandstream Brand Package.

              If you just need support for the GXP2130 it should be there.

              If you want support for the 2140 and 2160 import the grandstream.tgz file I just sent you. (Connectivity -> Advanced Settings -> Package Import/Export -> Import Brand Package.

              1. (I meant the latest OSS Endpoint Manager -

                1. Upgrade was automatic through the GUI. However something was broken in the upgrade. When I went to edit and extension through Applications | Extensions I got the error:

                  Can't load endpoint manager database

                  Maybe a reinstall of the module would work. But at this point I have figured out how to use Grandstream's XML configuration tools. I only have six or so phones to configure so I think this is the route I am going to go. Thank you for your help.

  11. Any Chance that someone has added or can add support for the new GXP2135 and GXP2170 phones?  I would be happy to help test.

  12. I am using OSS Endpoint manager, with Freepbx version 13.2.0 and I can't seem to add devices to the endpoint device manager, I keep getting this error: 

    Whoops \ Exception \ ErrorException (E_WARNING)

    copy(): The first argument to copy() function cannot be a directory

    1.  return(FALSE);
    2.  }
    3.  } else {
    4.  if (file_exists(PHONE_MODULES_PATH . "endpoint/" . $phone_info['directory'] . "/" . $phone_info['cfg_dir'] . "/" . $data)) {
    5.  if (!file_exists(dirname($write_path . $data))) {
    6.  !@mkdir(dirname($write_path . $data), 0775);
    7.  }
    8. copy(PHONE_MODULES_PATH . "endpoint/" . $phone_info['directory'] . "/" . $phone_info['cfg_dir'] . "/" . $data, $write_path . $data);
    9. chmod($write_path . $data, 0775);
    10.  }


    I Can't seem to find any fixes, Ive searched for two days and completely rebuilt my asterisknow server. Any help is greatly appreciated. Thanks!


  13. FreePBX

    OSS PBX End Point Manager

    PHP 5.3.3 (cli) (built: Aug 11 2016 20:33:53)

    Time Zone set to same as freePBX

    Try to create an extension (Polycom 650) and I get:

    Error Returned From Timezone Library: DateTimeZone::__construct(): Unknown or bad timezone (america/los_angeles)

    Any clue why?