This page describes FreeSWITCH™ numbering conventions, basic download instructions, and directions to useful installation pages.
The FreeSWITCH™ numbering format is "version.release.maintenance".
Selecting a Version
The primary FreeSWITCH™ releases are:
- Current Public Release 1.10, created 5 August, 2019, is recommended for production systems. Sounds and prompts release is 1.0.52 as of 19 August, 2016.
- Current Branch, contains in-test fixes going into the next maintenance level of the current public release.
- Development, containing the latest fixes and features, intended as the next release.
A Note About Bugs and Issues
Bugs or issues with the current public release must be tested using the latest Development release to determine if the problem is already fixed. Issues must be tested using Development before opening bug reports for them to be considered. If the bug persists in Development, then file an issue on GitHub: https://github.com/signalwire/freeswitch/issues
Check Release Notes Before Upgrades
There are breaking changes between minor and major releases, so make sure to check the Release Notes before upgrading to avoid headaches.
If you're using FreeSWITCH™ version 1.8 which is tagged End Of Life, you should upgrade to 1.10 NOW.
Download Current Public Release
The latest maintenance level of the current public release of FreeSWITCH™ can be downloaded from freeswitch-files via a browser. For linux, it's easier to copy/paste the command line below. This single long 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
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 the latest development release using the "git clone" command below which creates the freeswitch directory and downloads the FreeSWITCH™ 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