Skip to main content

Installation on OS X 10.11 El Capitan

Archived Page

Archived Obsolete - No Longer Maintained

As of December 31, 2018, FreeSWITCH is longer tested on OS X El Capitan. Apple dropped support and no longer issues security patches. Also, Homebrew no longer officially supports El Capitan.

FreeSWITCH installed and worked fine on El Capitan as of the dates below. To install, follow the manual installation instructions.

OS X FreeSWITCH™ Testing History

ReleaseTestedFreeSWITCH™ VersionStatus
10.11.6 El CapitanDecember 31, 2018December 31, 20181.8.4 Current Public Release1.9.0+git~20181227 Master DevelopmentBad - See below*Good

*Fixed in 1.8.4 branch, and will be fixed in 1.8.5 but no testing will be done.

Download Xcode (No Longer Required as of December 2017)

Xcode takes a while to download and is placed into the Applications folder (/Applications directory) with the Command Line Tools in /Applications/Xcode.app/Contents/Developer.

This Xcode Download requires you to sign in with your Apple ID and agree to the Software Agreement:
El Capitan 10.11: download and install Xcode 7.3.1 from Xcode 7.3.1 Download then start Xcode. NOTE: Xcode 8 CANNOT be used. See FS-9521.

For OS X 10.11 and 10.12: NEVER delete the /usr/local directory! It's very difficult to recreate, it must be restored from a backup. This is due to System Integrity Protection (aka rootless) security.


Archived Page

Archived Obsolete - No Longer Maintained

As of July 17, 2016, the page below is no longer maintained by the original author and is marked as archived. It is replaced by these instructions: macOS Developer Tools.

About

This is part of the macOS Installation guide for installing and running FreeSWITCH™. This page describes the installation of components that may be unique to OS X 10.11.

OS X Developer Tools

The OS X Developer Tools are composed of two parts, the Xcode 7 OS X Software Developer Kit used to develop and test OS X GUI applications, and the Command Line Tools that provide LLVM, Clang, Git and other tools required to generate non-GUI applications such as FreeSWITCH™ and its prerequisites. The Command Line Tools are included and automatically installed with Xcode. The Apple Developer site offers the standalone CLT but it cannot be used because Homebrew will not install without the Xcode/CLT version.

Install Xcode

Install Xcode using the OS X App Store application or download it from the OS X Developer site which requires a minimum of a free membership. Xcode takes a while to download and is placed into the Applications folder (/Applications directory) with the CLT in /Applications/Xcode.app/Contents/Developer. Once installed start Xcode to accept the license agreement.


Continue Installation

Continue at Installation and Testing on OS X - Installation is Complete.