Call Us Today! 877.742.2583

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

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 86 Next »


This page describes FreeSWITCH™ numbering conventions, basic download instructions, and directions to useful installation pages. 

 Click to expand Table of Contents


The FreeSWITCH™ numbering format is "version.release.maintenance". The release numbering convention is even numbers for production releases and odd numbers for development branches.

Current Production

The current production version/release of FreeSWITCH™ recommended for production systems is 1.6, created 8 September, 2015 followed by maintenance levels. The current release of sounds and prompts is 1.0.51 as of 9 October, 2014 .

If you're using FreeSWITCH™ version 1.4 which is tagged End Of Life, you should upgrade to 1.6 NOW. If you find bugs or issues with 1.6, please file a JIRA ticket.

The latest maintenance level of the current production version of FreeSWITCH™ can be downloaded via a browser. If you're using linux it's much easier to copy/paste the long command line below. This single line performs: 1- Determines the latest stable production release available. 2- Downloads the compressed source file. 3- Decompresses the file into a folder in the current directory. 4- Renames the folder to freeswitch. If you don't want the folder renamed remove the last && to the end of the line.

FSfile=$(curl -s | sed -n 's/.*"\(freeswitch\-[0-9]*\.[0-9]*\.[0-9]*\.tar\.gz\)".*/\1 /p' | tail -n 1) && echo Downloading $FSfile && curl$FSfile | tar -xz && mv ${FSfile/.tar.gz//} freeswitch

A Note About Bugs and Issues

The developer team only considers bug reports if the bug was first tested using the latest Master branch because it's very possible the problem was fixed.

Master Development

The master development release contains the latest fixes and features going into the next release. The current branch contains fixes going into the next maintenance level for the release. If there are problems with the stable production version, the developers will request that you install the master version or current branch for diagnosis.

Download the master version using the first "git clone" command below. Download the current branch using the -b argument followed by 'v' concatenated with the version number as in the second command below. The git command creates the freeswitch directory and downloads the FreeSWITCH™ source files. 

  git clone freeswitch.git   # Master Development
  git clone –b v1.$ freeswitch.git   # Branch, replace $ with release number



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

How To

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


Installation Methods

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) The development team uses and builds against Debian 8 "Jessie". They recommend Debian because of its stable, yet updated, kernel and wide support. 

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

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 can be found at Mac OS X Archive.


Compile with Visual Studio.

  • No labels