Call Us Today! 877.742.2583

Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »


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.

Warnings About Upgraded Systems

In some cases, systems that were upgraded from older software 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.


Upgraded OS X?

Most upgraded OS X systems work depending on the level of the oldest original system. Systems upgraded from 10.7 or older may have problems due to old files left in various directories. 

Upgraded Xcode?

Most upgraded Xcode systems will work depending on the level of the oldest original Xcode. Xcode upgraded from version 4 or earlier may have problems.

Prerequisites Previously Installed Differently?

If prerequisites were previously installed using different methods than described here, there may be problems.

If there are problems installing FreeSWITCH™, check if OS X or Xcode was upgraded from a very old release. The older the original system the more likely problems will occur, you may need to build OS X from scratch.




Installation of FreeSWITCH™ on OS X can be performed using the AppleScript installer, or manually.--

AppleScript Installation

The OS X FreeSWITCH™ Installer simplifies installation of FreeSWITCH™ on OS X by automating 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.

The OS X FreeSWITCH™ Installer

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 add to the system.

The installer is only available for OS X10.9 or later.--

Manual Installation

A manual installation involves:

  • Apple Xcode that provides the tools needed to generate everything else
  • Prerequisite packages that FreeSWITCH™ needs to function
  • FreeSWITCH™ itself

There is a little extra information for people who want more than others. If you're not too technical don't let the explanations intimidate you. Just follow the steps and FreeSWITCH™ should be installed in about an hour or two.

Select OS X Release

Click a link below to view instructions. The pages link back here to continue.


                                      FreeSWITCH™ OS X Release Status

ReleaseTestedInstallation 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  

Installation on OS X 10.10 Yosemite 

  10.9.5 Mavericks  October 3, 2015  Installation on OS X 10.9 Mavericks
  Mac OS X Archive Mac OS X Archive 


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

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:

  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 CallsTest as many functions as you can to experience the potential of FreeSWITCH™.

Shutdown FreeSWITCH™

Issue the following command in the FreeSWITCH™ Terminal window:



What Next?

Once FreeSWITCH™ has been tested it time to customize OS X. The Customization on OS X instructions will keep you busy!

  • No labels