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.13.6 High Sierra

April 24, 2018

July 30, 2018

1.6.20 Current Production

1.9.0+git~20180726 Master Development

Bad see FS-11061

Bad see FS-11270

10.12.6 Sierra

January 26, 2018

June 30, 2018

1.6.20 Current Production

1.9.0+git~20180619 Master Development



10.11.6 El Capitan

April 24, 2018

July 22, 2018

1.6.20 Current Production

1.9.0+git~20180719 Master Development

Bad see FS-11061



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,