About

This page describes the FreeSWITCH™ installation methods available for macOS 10.12, OS X 10.11, and 10.10. It is part of the FreeSWITCH™ macOS documentation.
 ---

Testing Status

Testing is performed using clean installs of macOS onto erased volumes, not upgraded systems.

 

                                                    macOS FreeSWITCH™ Testing Status

macOSXcodeTestedFreeSWITCH™ VersionStatus

10.13 High Sierra

Beta 2

9.0.0

June 23, 2017

June 23, 2017

1.6.18+git~20170622 Production Release

1.9.0+git~20170623 Master Development

Good

Good

10.12.5 Sierra8.3.3

June 14, 2017

June 14, 2017

1.6.18+git~20170612 Production Release

1.9.0+git~20170613 Master Development

Good

Good

   10.11.6 El Capitan7.3.1

June 3, 2017

June 3, 2017

1.6.17+git~20170601 Production Release

1.9.0+git~20170602 Master Development

Good

Good

  10.10.5 Yosemite7.2.1

June 23, 2017

June 23, 2017

1.6.18+git~20170622 Production Release

1.9.0+git~20170623 Master Development

Good

Good

 

 


Backup!

This procedure installs a significant amount of software, almost all of it can be removed easily. 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.

Upgraded macOS or Xcode?
Upgraded systems that originally contained software older than 10.8 Mountain Lion or Xcode 5, will have unresolvable 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 information and download is located 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,