This page describes FreeSWITCH™ numbering conventions, basic download instructions, and directions to useful installation pages.
The FreeSWITCH™ numbering format is "version.release.maintenance". The release numbering convention is even numbers for production releases and odd numbers for development branches.
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.
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.
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 release number, see the second command below. The git command creates the freeswitch directory and downloads the FreeSWITCH™ source files.
If you're new to FreeSWITCH™ consider purchasing the Mastering FreeSWITCH™ book and be sure to read this introductory article: http://www.linuxpromagazine.com/Issues/2009/106/TALK-SOFT.
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.