Call Us Today! 877.742.2583

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



Ubuntu 11 is deprecated. Please use Ubuntu 16.04 Xenial

 Click here to expand Table of Contents

Introduction to Ubuntu and FreeSWITCH

This page was intended to help those who want to install FreeSWITCH, and not start learning how FreeSWITCH actually works. This will give you the basic setup so that you can at least start making calls.

Please also review the entries for Debian and Ubuntu under for some more information before proceeding.

Initial Setup

The instructions below have been updated for 11.04+.

Note that in the command line examples, the editors Nano (command name "nano") or Vim (Vi Improved, command name "vim") are mentioned. Any text editor (gedit, emacs, etc.) should be able to be substituted. Often this command is in the EDITOR environment variable (referenced with $EDITOR).

Install the standard Ubuntu server system.

Install from Repo

There are packages in the repo for distributions up to Maverick. If you're running a later version (which you probably are...), you should build freeswitch manually or create deb packages and install them (see next section).

Open a terminal window (if necessary) and then type these commands:

Following the above will get you a basic installation of FreeSWITCH installed in /opt/freeswitch.

Create Ubuntu packages and install them

This script will download everything required, build packages and installs them. It works on a basic installation. Save it as in your home directory and start it with

It's (always) recommended to build as a regular user, NOT root. Tested on Ubuntu 12.04 LTS, with Freeswitch 1.2.9 (which means seperate music and sounds package). Partly based on the Debian installer script.

It will give a permission error when starting freeswitch, disable spandsp in /etc/freeswitch/autoload_configs/modules.conf to avoid this, didn't look into the problem as of yet. You can run Freeswitch as root also.

Old method for building packages

Also, make sure to check out debian/README.source and debian/README.Debian as those are updated when significant changes are made to the debian build or setup process.

Build from source

It's recommended to build Ubuntu packages..

Install dependencies

Open a terminal window (if necessary) and then type these commands:

Build and install with makefiles

Run the following in the freeswitch directory:

Problem info from the quick and dirty page

The quick and dirty page is now generic and this info was recent and for Ubuntu:

Using FreeTDM with the 'direct from git' method above

earthspike, 2011-06-05

The /dev/wan* are owned by root.root, so this needs to change for mod_freetdm to work correctly.

I got mine to work (on 10.04.2 LTS) by:

  • Create user and group freeswitch as described above. Command for adding the group is

  • Change the group ownership on the devices:


  • Restart freeswitch if already running:


  • Use fs_cli to check that your TDM spans are showing:


Issues with specific Ubuntu releases

Ubuntu 10.04 LTS 64bit

Tested Dec 23, 2010 with Ubuntu
There were no issues during installation and testing.

Ubuntu 11.10 64bit

Tested Oct 14, 2011 with Ubuntu
Tested Oct 26, 2011 with Ubuntu
The default awk is now mawk and not gawk. Gawk must be installed to compile successfully. Changes in the default GCC toolchain behavior may require other tweaks like the ones described here.

For the latest git head (2011/10/26), libz and pkg-config, are dependencies that were required to build properly. libjpeg-dev is required for spandsp

Note: If you receive errors in libs/iksemel complaining of an expected ")" this may point to the pkg-config package not being installed. After installing pkg-config you will need to bootstrap the environment again to expand the proper aclocal macros.

To resolve the dependency on gawk, the system awk link was updated to point to gawk using the following command

  • No labels