This section describes the process of installing and performing basic testing of FreeSWITCH™ and its prerequisites on macOS 10.12, OS X 10.11, and 10.10. Instructions for older releases are located at the Mac OS X Archive.

Testing History

Testing is performed on clean installs of macOS, not upgraded from a prior macOS release.


                                                    macOS FreeSWITCH™ Testing History

ReleaseTestedXcodeFreeSWITCH™ VersionStatus

10.12.3 Sierra

March 9, 2017

 February 4, 2017


1.6.15+git~20170309 Production Release

1.9.0+git~20170204 Master Development



  10.11.6 El Capitan

March 4, 2017

March 4, 2017


1.6.15+git~20170303 Production Release

1.9.0+git~20170304 Master Development



  10.10.5 Yosemite

March 4, 2017

March 4, 2017


1.6.15+git~20170303 Production Release

1.9.0+git~20170304 Master Development







This procedure installs a significant amount of software, all of it can be removed. However, some of the Apple Command Line Tools, part of Xcode may remain. There is no problem leaving these small parts installed, but to restore to a point where nothing was installed a backup is required before starting this procedure.

Terminal Application Preferences

The Terminal application is used extensively during installation, and to start FreeSWITCH™. The following changes are recommended to save time:

  1. Copy Terminal in the Applications/Utilities folder into the Dock for quick access.
  2. Start the Terminal application by clicking it in the dock. Then open its preferences panel.
  3. In Settings–>Profiles–>Window change the Window Size to larger values such as 140x48 to reduce having to resize the window often.
  4. In Settings–>Profiles–>Window set Scrollback to "Limit to Available Memory" or a larger number. Many messages are produced that may be needed for problem analysis.
  5. In Settings–>Profiles–>Shell set Prompt before closing to "Only if there are processes other than:". This prevents the Terminal window from closing when FreeSWITCH™ is shutdown if it started automatically, which would result in the loss of all messages in the window. This is useful during debugging. If FreeSWITCH™ started manually the window does not close.



Upgraded macOS or Xcode?
Upgraded systems that originally contained 10.7 Lion or older, or Xcode version 4 or older, will likely have significant problems.

Prerequisites Previously Installed Differently?

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

Installation Methods

Installation of FreeSWITCH™ on macOS can be performed using the macOS FreeSWITCH™ Installer (macFI), or manually.

macOS FreeSWITCH™ Installer (macFI)

The macOS FreeSWITCH™ Installer is the recommended method since it simplifies installation by automating all of the manual steps. Aside from being much faster, other advantages include renaming existing FreeSWITCH™ directories before installation, and creating installation logs. The macFI can be downloaded at macOS macFI Installation.

The macOS FreeSWITCH™ Installer performs the identical functions as a manual install with additions such as logging.

Manual Installation

A manual installation involves downloading and installing Xcode, prerequisites and FreeSWITCH™ by entering commands into the Terminal application.

To perform a manual installation use the macOS Manual Installation instructions,