Skip to content

Update mod_com_g729 setup instructions #274

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
briankwest merged 2 commits into from
Sep 18, 2025
Merged

Update mod_com_g729 setup instructions #274

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
dcef08e
Update mod_com_g729 setup instructions
Len-PGH Sep 18, 2025
9e67aec
Update mod_com_g729_1049284.mdx
Len-PGH Sep 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 26 additions & 24 deletions docs/FreeSWITCH-Explained/Modules/mod_com_g729_1049284.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,21 +15,25 @@ G.729 uses roughly 1/8th of the bandwidth of a G.711 (8 kbit/s vs 64 kbit/s).

The module is packaged separately from the rest of FreeSWITCH.

It can be downloaded from [http://files.freeswitch.org/g729](http://files.freeswitch.org/g729/)
If you don't have FreeSWITCH packages configured use:
```
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token> release
```
This will setup the FreeSWITCH Release Debian repository.
* [If you need a PAT click here for instructions.](https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/how-to-create-a-personal-access-token/how-to-create-a-personal-access-token)

Once the FreeSWITCH repository is configured, `apt-get install freeswitch-license-server freeswitch-mod-com-g729`

Make sure that passthrough [mod\_g729](mod_g729_3375549.mdx#about) is not loaded at the same time as mod\_com\_g729.

Full installation instructions are available at the above link in the INSTALL.txt file.
* Please note that mod_com_g729 is supported on Debian 11+ and no longer supported on Centos

You should make sure that [mod\_g729](mod_g729_3375549.mdx#about) is not loaded at the same time as mod\_com\_g729.

### Quick install

```xml
cd /tmp
apt-get install unzip
wget files.freeswitch.org/g729/fs-latest-installer-v1.6
chmod +x fs-latest-installer-v1.6
./fs-latest-installer-v1.6 /usr /usr/lib/freeswitch/mod
/usr/bin/freeswitch-license-validator
apt-get install freeswitch-license-server freeswitch-mod-com-g729
freeswitch-license-validator
unzip licences.zip

cp <HEX-KEY>.conf /etc/freeswitch/ # <--- must be "/etc/freeswitch" for its a hard coded path freeswitch_licence server will search
Expand Down Expand Up @@ -57,18 +61,17 @@ pkill -HUP freeswitch_licence_server
systemctl start freeswitch
```


### Linux

Download the fs-xxx-installer (currently [http://files.freeswitch.org/g729/fs-201501231218-installer](http://files.freeswitch.org/g729/fs-201501231218-installer)) file, make it executable and run it. This will install the module and supporting software to /usr/local/freeswitch or /opt/freeswitch (autodetected). If you are not using one of these directories for FreeSWITCH installation (e.g. using standard Debian directory layout), then you will need to pass two command line parameters:

./fs-xxx-installer [bin_dir modules_dir]
#### Segmentation fault

For example:
This will usually happen after upgrading from an older version of Debian to a newer version. Please uninstall and reinstall
* `apt-get remove freeswitch-license-server freeswitch-mod-com-g729`
* `apt-get install freeswitch-license-server freeswitch-mod-com-g729`

./fs-201501231218-installer /usr /usr/lib/freeswitch/mod
#### Hardware changed

Your /bin directory will then contain an executable named validator, run this to enter your sales codes (see Licensing) and download your licences.zip file. This file contains your licences which should be extracted to /etc/freeswitch.
If you change hardware or to a new instance, you will have to have the license reset to activate on the new hardware or instance.
ERROR [hardware changed, see http://wiki.freeswitch.org/wiki/Mod_com_g729#Licence_details]
* [License reset](https://endor.freeswitch.com/cart.php?gid=15) is required for activation on the new hardware or instance

#### No Hardware Detected

Expand Down Expand Up @@ -100,13 +103,13 @@ Licences are linked to a particular server. This is achieved by linking the lice

While FreeSWITCH is running you are able to add more licenses without stopping calls. Run the G729a validator program for your new license codes:

/usr/local/freeswitch/bin/validator
freeswitch-license-validator

Enter each of your **newly purchased** license numbers on a new line and finish by entering a blank line.

Follow the installation instructions [as per the guide](http://files.freeswitch.org/g729/INSTALL.txt) to add your license file to FreeSWITCH and confirm that you do wish to overwrite your old license files when asked. Now that you have updated your licenses you need to re-start the license server which is already running. Kill the process for freeswitch\_licence\_server and it should automatically restart as soon as a call requests to use g729a. If the license server does not automatically restart itself you can manually start it by issuing this command:
Follow the installation instructions to add your license file to FreeSWITCH and confirm that you do wish to overwrite your old license files when asked. Now that you have updated your licenses you need to re-start the license server which is already running. Kill the process for freeswitch\_licence\_server and it should automatically restart as soon as a call requests to use g729a. If the license server does not automatically restart itself you can manually start it by issuing this command:

/usr/sbin/freeswitch_licence_server
freeswitch_licence_server

## API Commands

Expand Down Expand Up @@ -146,7 +149,7 @@ If you are running FreeSWITCH with a different user and you add more G729 licens

### Saving Config Files

After activating, you should keep your zip files around for backups. There's a maximum of 3 activates per license. If you don't read this until it's too late, then you can send an email to [g729-support@freeswitch.org](mailto:g729-support@freeswitch.org) to have it reset once so that you can back up the files to use in the future.
After activating, you should keep your zip files around for backups. There's a maximum of 3 activates per license. If you don't read this until it's too late, then you can send an email to [support@signalwire.com](mailto:support@signalwire.com) to have it reset once so that you can back up the files to use in the future.

### Phone wants G729A

Expand All @@ -172,8 +175,7 @@ On Linksys (or Cisco SPA5XX) phones & ATAs you have to rename the G729 codec nam

* [Codecs](https://wiki.freeswitch.org/wiki/Codecs "Codecs")
* [Modules](index.mdx#about)
* [G729 Downloads](http://files.freeswitch.org/g729/)
* [FreeSWITCH website - click Commercial Modules tab to purchase licenses](https://freeswitch.com/cart.php?gid=2)
* [FreeSWITCH website - click Commercial Modules tab to purchase licenses](https://endor.freeswitch.com/cart.php?gid=15)
* [G729 Wiki](http://en.wikipedia.org/wiki/G.729)