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


mod_opal is a multi-protocol capable endpoint module, based on the Opal telephony library. It adds H.323 and IAX2 support to FreeSWITCH.

This module is still considered beta quality. It may or may not work as expected and some features may be missing.

 Click here to expand Table of Contents


Beta. This module is available since FreeSWITCH 1.0.2 (svn revision #10734, 2008-12-12)


If you would like to try mod_opal be sure to use the '' script in the build subdirectory of the FreeSWITCH source directory. This script will install OPAL and the required PTLIB. Also, be sure to update your FreeSWITCH installation to the latest Git.  Michael S Collins, 2009-05-04

Manual Build

You need to install Opal and it's dependencies first, before you can install mod_opal. Here's a short list of instructions:

mod_opal needs the current svn versions of ptlib and Opal


Install ptlib first:

Opal is next:

Now you're ready to build mod_opal:


The configuration is separated into a global ("settings") and a listener section.


This configuration creates a new H.323 listener for the host's main ip detected by FreeSWITCH on port 1720 (the H.323 default port).

To permit incoming calls to the FS server edit the vars.xml file and set the var domain_name which will use opal/h323 to redirect calls to extensions.

Add this into vars.xml files:

The FS server is now ready and knows who sent the h323 calls from the external equipment.



These examples may be wrong

Example: call to extensions 26xx into the Server Cisco Call Manager that support H.323.
Add this into /opt/freeswitch/conf/dialplan/default.xml:



API commands




Channel Variables


Known Bugs

Features missing etc.

See Also