Skip to main content

Installation on OS X 10.10 Yosemite

Archived Page

Archived Obsolete - No Longer Maintained

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

FreeSWITCH installed and worked on Yosemite as of the dates below. Add the "Create /usr/local Subdirectory" instructions below to the manual installation instructions.

OS X FreeSWITCH™ Testing History

ReleaseTestedXcodeFreeSWITCH™ VersionStatus
10.10.5 YosemiteDecember 31, 2017December 31, 20177. Current Production1.9.0+git~20171228 Master DevelopmentGoodGood

Create /usr/local Subdirectory

In OS X 10.10 Yosemite /usr/local is not supplied so it must be created by running the following commands in Terminal, sudo will prompt for the administrator password:

  cd /usr
sudo mkdir local # Create the /usr/local directory

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/

This Xcode Download requires you to sign in with your Apple ID and agree to the Software Agreement:
Yosemite 10.10: download and install Xcode 7.2.1 from Xcode 7.2.1 Download then start Xcode. Perform Rename Xcode Directory (As of Xcode 7.1).

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.


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.10**.**

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 7.2

Xcode 7.2 is no longer available from the OS X App Store so must be downloaded 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/ Once installed start Xcode to accept the license agreement.

Rename Xcode Directory (As of Xcode 7.1)

The command line tools installed by Xcode 7 are for OS X 10.11, these tools work fine on OS X 10.10. However, Homebrew checks for the 10.10 version if running under OS X 10.10. If it does not find them it prompts you to install them separately. That is not required if you rename (a rename is required as an alias does not work) the command line tools directory as follows:

  1. Open the Applications folder and select Xcode.
  2. Control+click Xcode to reveal the contextual menu and select Show Package Contents.
  3. Navigate to: Contents –> Developer –> Platforms –> MacOSX.platform –> Developer –> SDKs –> MacOSX10.11.sdk
  4. Select MacOSX10.11.sdk and press Enter
  5. Change the 10.11 to 10.10 and press Enter. The directory name must be MacOSX10.10.sdk

Continue Installation

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