This page describes the FreeSWITCH™ installation FreeSWITCH™ installation methods available for the macOS 10.12, OS X 10.11, and 10.10. releases below. It is part of the FreeSWITCH™ macOS documentation.
Weekly testing of the FreeSwitch Master Development version is
suspended due to build errors since August 1 2021.
macOS testing was performed only on Intel Macs, M1 Arm testing may begin if macOS building resumes.
All macOS versions are installed into new volumes with the latest Apple Command Line Tools. Upgraded systems are never used.
Upgraded macOS or Xcode?
Prerequisites Previously Installed Differently?
If prerequisites were previously installed using methods other than described here, there may be problems.
History for older releases is at the macOS Archive.
This is the easiest method to install FreeSWITCH™ and is a good way to get the feel of FreeSWITCH with the least time and effort. The disadvantages are that it can only install the current production version and is very limited because additional modules cannot be easily built if they are not part of the default set.
To perform a Homebrew installation use the macOS Homebrew Installation instructions.
Until further notice, this is the ONLY WAY to install FreeSWITCH on macOS. See Status above.
macOS FreeSWITCH™ Installer (macFI)
The macOS FreeSWITCH™ Installer is the recommended method since it simplifies installation by automating because it automates all of the manual steps. Aside from being much faster, other advantages , 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.
A manual installation involves downloading and installing Xcode, prerequisites and FreeSWITCH™ by entering commands into the Terminal applicationrequires 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,