This is the home page of the sections that describe installing and performing basic testing of FreeSWITCH™ and its prerequisites on OS X.
If you have not read the Mac OS X page please view it now.
All testing for these instructions was performed on a clean/non-upgraded OS X and Xcode system, without issues. Most upgraded OS X or Xcode systems will work depending on the level of the oldest software. Some upgraded systems had problems due to old files left in different directories.
If there are problems installing prerequisites check if the OS X release was upgraded, for instance from 10.7 or 10.8 to a newer system. The older the original system the more likely problems will occur.
Also check if Xcode was upgraded, for instance from Xcode 4 or 5 to a newer Xcode. The older the original Xcode the more likely problems will occur.
In some cases older upgraded systems had issues due to old parts of a prior OS X or Xcode still intact. In these cases a fresh OS X and Xcode install may required.
|If prerequisites were previously installed using different methods and there are problems, you should build OS X from scratch. In tests, using Homebrew or the script below worked every time on freshly installed OS X systems.|
Installation of FreeSWITCH™ on OS X can be performed using the AppleScript installer, or manually.
The OS X FreeSWITCH™ Installer simplifies installation of FreeSWITCH™ on OS X by automating the all of the manual steps, except for prompting for an administrator password. It creates logs that are useful in case of problems. The installer can be downloaded at Installation on OS X using AppleScript.
Even if you use the OS X FreeSWITCH™ Installer it's a good idea to read the manual instructions so you know what the installer will adding to the system.
The installer is only available for OS X10.9 or later.
To manually install FreeSWITCH™ on OS X, click a link below to view instructions. The pages link back here to continue.
This section is used to allow the previous pages to return to this location. Do not remove this section.
The time has come to start FreeSWITCH™ in a Terminal window:
cd /usr/local/freeswitch/bin ./freeswitch
There are many startup messages ending with some text boxes containing the names of the developers.
After all startup messages are displayed a command prompt appears, messages may continue as the prompt remains. Try a few FreeSWITCH™ commands:
version status sofia status
If the commands return responses FreeSWITCH™ is working and you can continue with the next step.
Test using a physical SIP phone or soft phone such as Bria, or search the OS X App Store for "SIP" for a free download of Telephone. Setup the phone using the IP address of the Mac FreeSWITCH™ is running on. The port is 5060, user IDs 1000-1019 with a password of 1234 are pre-configured. Additional information is at Test Calls. Test as many functions as you can to experience the potential of FreeSWITCH™.
Issue the following command in the FreeSWITCH™ Terminal window: