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 current public releases and odd numbers for development branches.
Selecting a Version
The primary FreeSWITCH™ releases are: Current public release, recommended for production systems. Current branch, contains in-test fixes since the current public release, intended as the next maintenance release. Master development, containing the latest fixes and features, intended as the next major release.
A Note About Bugs and Issues
If you find bugs or issues with the current public release, they must be tested using the latest Master because it's possible the problem was fixed. Also, the developers require all bugs to be tested using the latest Master before considering any bug reports.
If the bug persists in Master, then you must file a JIRA ticket.
If you're using FreeSWITCH™ version 16 which is tagged End Of Life, you should upgrade to 1.8 NOW.
Download Current Public Release
The current public version/release of FreeSWITCH™ recommended for production systems is 1.8, created 31 July, 2018 followed by maintenance levels. The current release of sounds and prompts is 1.0.51 as of 9 October, 2014.
The latest maintenance level of the current public version of FreeSWITCH™ can be downloaded from freeswitch-files 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 public 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.
Download Current Branch
The current branch contains fixes going into the next maintenance level for the release. Download the current branch using the -b argument followed by 'v' concatenated with the release number. The git command creates the freeswitch directory and downloads the FreeSWITCH™ source files, replace # with the release number.
Download Master Development
The master development release contains the latest fixes and features going into the next release. Download the latest master release using the "git clone" command below which creates the freeswitch directory and downloads the FreeSWITCH™ master development 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.