Introduction
Who Is This For?
This document is for people not familiar with Unix commands and directories. The detailed explanations insinuate a long procedure, don't let that deter you, it takes about two hours to have the sample FreeSWITCH™ configuration running on OS X, not including backups.
What You Should Already Know
You must know your way around the OS X Finder, Dock and Textedit. You should also be familiar with the standard OS X folders (directories) such as Applications, Utilities, Downloads, Users, etc.
New To You
A new folder (directory) called /usr/local, it's part of the UNIX standard directories. We'll use a few Unix commands such as: cd, mkdir, ls, cp, mv,chmod, chown, and sudo. You don't need to learn about them unless you change the steps or directories used in this document.
Installation
Using an Upgraded OS X or Xcode
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.
The OS X FreeSWITCH™ Installer
If the OS X system is 10.9 or later, consider using the OS X FreeSWITCH™ Installer. It automates most of the steps in the release instructions below and saves a lot of time! Check it out at Installation on OS X using AppleScript.
Select OS X Release
To manually install FreeSWITCH™ on OS X, click a link below to view instructions. The pages link back here to continue.
FreeSWITCH™ OS X Release Status
Release | Tested | Installation Wiki Page |
---|---|---|
10.11.0 El Capitan | October 3, 2015 | Installation on OS X 10.11 El Capitan |
10.10.5 Yosemite | October 3, 2015 | |
10.9.5 Mavericks | October 3, 2015 | Installation on OS X 10.9 Mavericks |
Mac OS X Archive | Mac OS X Archive |
xxx
Installation is Complete
This section is used to allow the previous pages to return to this location. Do not remove this section.
Test FreeSWITCH™!
Startup From the Command Line
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.
Test the FreeSWITCH™ Command Prompt
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 A Phone
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™.
Shutdown FreeSWITCH™
Issue the following command in the FreeSWITCH™ Terminal window:
shutdown