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


The current production release of FreeSWITCH™ is version 1.6 created 8 September, 2015 with later point releases. This is the recommended version to install for production systems.The current release of sounds and prompts is 1.0.51 as of 9 October, 2014 .

FreeSWITCH™ version 1.4 is tagged END OF LIFE, so it is wise to test version 1.6 NOW and upgrade to it if all works as expected in your environment. If you find bugs or omissions, please file a ticket on JIRA so that version 1.6 is the best it can be. Thanks.



 Click to expand Table of Contents


The template that we follow assigns even version numbers to production releases and odd version numbers to development branches. Where you see instructions to retrieve code like

git clone freeswitch.git

you can obtain a specific branch with the -b argument followed by 'v' concatenated with the version number, for example

git clone –b v1.6 freeswitch.git





FreeSWITCH Adavantage

FreeSWITCH Advantage Support

The FreeSWITCH Advantage provides commercial-grade support services based on a trouble-free installation package to get you up and running quickly and profitably.

Full details available at

The git repository has been replaced by Stash. See the Makefile scripts for CentOS or Debian 7 or the Developers page under Community for specifics.


Pick Your Pill

Easy Way

The easiest way to get FreeSWITCH™ is to install the package for your operating system. Pre-built binaries are available for installation on some Linux and Unix distributions as well as Windows.

Debian 8 Package (FreeSWITCH 1.6)

Debian 8 Jessie (preferred)

Centos 7 Package (FreeSWITCH  1.6)

CentOS 7 and RHEL 7


Freeswitch Installer .msi

The binary MSI installer is built each weekend from Git head, includes default modules and 8KHz sounds, and is available for both x86 (32-bit) and x64 (64-bit).

Compiling Master Source Code

If you require the very latest features or patches or wish to hack FreeSWITCH you may compile from source code. FreeSWITCH™ is available for source compilation on Unix and Linux distributions as well as Windows.

Debian 8 Jessie Source

FreeSWITCH™ 1.6 depends on a number of libraries included with Debian 8, which is now the distribution of choice for FS core development team. Follow the instructions on the Debian 8 Jessie page; refer to Debian Post-Install Tasks for finishing touches.


The comprehensive macOS guide contains instructions for setting up FreeSwitch™ on a Mac with features such as autostart, emailing voicemails and log management.


Special notes for building from source on OpenBSD.


Recently updated installation guide for SmartOS

The core developer team will only entertain bug reports on the latest Master branch code—it is impossible to debug old code that has long since changed and might have been patched already.

On this page you will find general information that applies to all installations of FreeSWITCH. Follow the links to your target operating system for specifics. The development team uses and builds against Debian 8 "Jessie". They recommend Debian because of its stable, yet updated, kernel and wide support. 

How To

If you're new to FreeSWITCH™ consider purchasing the Mastering FreeSWITCH™ book and be sure to read this introductory article:

Updating Binaries

Config Changes

In version 1.4 the names of a number of configuration settings were changed, so you can not simply use old config files on your new FreeSWITCH™ binaries.

Settings of the form sip_*_media have become rtp_*_media because they properly control RTP media streams, SIP has nothing to do with them.

For example, sip_secure_media is now called rtp_secure_media.


Deprecated Instructions


Deprecated Packages

FreeSWITCH™ is developed on Debian 8 "Jessie" which is the much preferred platform. These instructions for older operating systems are maintained as a courtesy, but are unlikely to work without a great deal of effort.

Debian 7 Package (FreeSWITCH 1.4)

Debian Wheezy Package

CentOS 6 Package

rpm -Uvh
yum install freeswitch-config-vanilla
yum install sox freeswitch-sounds*

Enjoy FreeSWITCH!

Deprecated Compiling From Source Code

These deprecated instructions are FreeSWITCH you may compile from source code. FreeSWITCH™ is available for source compilation on Unix and Linux distributions as well as Windows.

Debian 7 Source

Makefile that builds FreeSWITCH™ including libraries and build dependencies.

CentOS 6 Source

Makefile that builds FreeSWITCH™ including libraries and build dependencies.

Unix Variants

Mac OS X

Instructions for non-supported OS X systems and FreeSWITCH 1.4 can be found at Mac OS X Archive.


Compile with Visual Studio.


  1. yum install freeswitch

    Enjoy FreeSWITCH!


    From what repo? base, epel -  not found

  2. Any current instructions for Raspberry PI?

    1. There were some individuals porting FreeSWITCH over to RPi. I don't know how the recent FS 1.6 changes affect that effort, however. Many of the changes in FS 1.6 involved switching to system libraries in Debian 8 along with greatly improved video conferencing support. Since an RPi is not up to the task of video processing I'm guessing you could omit much of that if you want to stay current with FS 1.6 or use the 1.4 branch.

    2. Ask and ye shall receive!

      Raspberry Pi

      1. As far as I can tell, 1.6 means the end of hosting FS on R-Pi.  In fact, there are no packages for arm in the repo.  Guess I'll have to buy a NUC.  

        1. A core motto of FreeSWITCH is: "Don't glue the Lego pieces together"

          FS is a modular system so you are not required to build every last piece, especially the extensive video components that come with 1.6 version. If you trim down what you build to the bare essentials there's no reason it should not run on RPi.

          These wiki comments don't see much exposure, so you're much better off asking on the Freeswitch-users mailing list. I know there is interest out there, but it is up to those who have the interest and expertise in RPi to take the ball and run with it. I'm pretty sure the core team doesn't have the wherewithal to port FS to RPi or other architectures as they have their hands full just getting things right with Debian (smile)

          1. John,

            I dug into the deps-most package found in the 1.6 installation instructions and attempted to manually install each of them.  Out of 47 dependencies, I found 11 of them were not available in the raspbian repos.  These are the packages that were not available.  

            libvpx2-dev | libvpx-dev (>= 1.4.0)

            Can you offer any advice on how to determine which modules depend on these?  I've searched a few in confluence and have found one reference to libyuv in mod_fsv, but I'm thiking there's got to be a better way to check if these are things I must have.

  3. the windows binary listed above never seem to be updated since January 2015

    1. The core team is working to update the Windows build system. God bless them since there are MANY changes that must be incorporated into the Windows libraries. The FreeSWITCH-users mailing list has the latest on that while it's underway.

      1. how about add a wiki on compile with VS so others know if the sdk and other tools required to build FS 1.6

      2. Seeing how http-cache is now getting installed together with freeswitch-config-vanilla it would be awesome to see http-cache included in default Windows install package as well, do you have any comment on that?

        1. Since Windows is not the core target environment, the core development team welcomes a Pull Request to include the necessary modules. (smile)