This page describes FreeSWITCH™ installation methods available for the macOS releases below. 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

macOSTestedFreeSWITCH™ Version/ReleaseStatus

10.14.2 Mojave

December 27, 2018

January 3, 2018

1.8.4 Current Public Release

1.9.0+git~20190102 Master Development

Bad - fixed in 1.8.5 and 1.8.4 branch


10.13.6 High Sierra

September 27, 2018

December 16, 2018

1.8.2 Current Public Release

1.9.0+git~20181212 Master Development



10.12.6 Sierra

September 27, 2018

December 8, 2018

1.8.2 Current Public Release

1.9.0+git~20181206 Master Development




History for older releases is at the macOS Archive.

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 because it automates all of the manual steps, providing much simpler and faster installation. 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 requires use of the Terminal application to enter commands to setup directories, install prerequisites and FreeSWITCH™.

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