About
This page describes the FreeSWITCH™ installation methods available for macOS 10.13, 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
macOS | Xcode | Tested | FreeSWITCH™ Version/Release | Status |
---|---|---|---|---|
10.13 High Sierra Beta 3 | 9.0.0 | June 23, 2017 July 11, 2017 | 1.6.18+git~20170623 Production Branch 1.9.0+git~20170711 Master Development | Good Good |
10.12.6 Sierra | 8.3.3 | July 13, 2017 July 19, 2017 | 1.6.19 Stable Production 1.9.0+git~20170719 Master Development | Good Good |
10.11.6 El Capitan | 7.3.1 | July 13, 2017 July 5, 2017 | 1.6.19 Stable Production 1.9.0+git~20170705 Master Development | Good Good |
10.10.5 Yosemite | 7.2.1 | July 22, 2017 July 22, 2017 | 1.6.19 Stable Production 1.9.0+git~20170721 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.
Installation Methods
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 downloading and installing Xcode. Then using the Terminal application to enter commands to setup directories, install prerequisites and FreeSWITCH™.
To perform a manual installation use the macOS Manual Installation instructions,