This is part of the Installation and Testing on OS X guide for installing and running FreeSWITCH™. This page describes the installation of FreeSWITCH™ on OS X using an AppleScript program that automates installation steps. The installer is occasionally updated with changes, new features and fixes if needed. Email the author with suggestions or issues.xx
Who Can Use The Installer Script?
The installer is available for any OS X 10.9 Mavericks or later system. Support for older systems is dropped as instructions for those systems are archived.
Why Use the Installer Script?
There are lot's of advantages to using the script as seen below. The primary ones are:
- For people new to FreeSWITCH™ it shields you from using Terminal commands and walks them through the whole process.
- It determines if steps were previously accomplished and performs only what's needed.
- It creates a folder of log files so it's easy to check for problems.
- It saves time for people doing a lot of testing. In fact, I developed this so I could click a couple of times then walk away!
What Does it Do?
The installer performs identical steps as described in Manual Installation. You should review the manual instruction before using the installer so you know what the program will change and install.
Here is the sequence of functions performed:
- Determines if it can run on the OS X release.
- Asks what function is desired, install or remove.
- For installation, what version to download.
- Checks for presence of Xcode.
- Checks for presence of Command Line Utilities.
- Checks if hidden files are visible.
- Checks if the required directories exists.
- Checks if the install directory has the correct ownership.
- Checks for presence of Homebrew.
- Checks for presence of prerequisites supplied by Homebrew.
- Checks for presence of prerequisites not supplied by Homebrew.
- Checks for presence of previous FreeSWITCH™ source and runtime libraries.
- Produces a list of actions to take and requests verification to proceed.
- If required, launches web pages to install Xcode.
- If required, launches functions to install Command Line Utilities.
- If required, makes hidden files visible.
- If required, creates directories exists.
- If required, changes the ownership of the install directory.
- If required, downloads and installs Homebrew.
- If required, updates prerequisites supplied by Homebrew.
- If required, downloads and installs prerequisites supplied by Homebrew.
- If required, downloads and installs prerequisites not supplied by Homebrew.
- If required, renames previous FreeSWITCH™ source and runtime libraries to prevent changes.
- Performs git clone of FreeSWITCH™.
- Performs bootstrap and configure.
- Adds FLITE to modules.conf.
- Performs make, make install, make install sounds, and make clean.
- Prompts for testing selection.
- If testing, opens web pages to FreeSWITCH™ information and displays IP address and port for phone configuration.
- If testing, launches FreeSWITCH™ to test.
If all that is not enough to use this script here is a bonus: Output from most terminal commands are separated and placed into a folder created on the desktop using a date and time stamp. Each of the following commands are logged:
- Install Homebrew
- Install prerequisites
- Download and install FreeSWITCH™ source
- bootstrap command
- configure command
- make command
- make install command
- make install sounds command
Installing the OS X FreeSWITCH™ Installer
It's incredibly easy to install, just follow this step:
- Click on this link, OS X will automatically download and unzip the file:
October 16, 2015 Add FreeSWITCH™1.6 support, update prerequisites add installation of non-homebrew support packages. Other changes.
October 3, 2015 added change ownership logic for /usr/local, change 10.9 Xcode 6 download, remove 10.8 and Xcode 5 support.
November 5, 2014 for Xcode 6.1 and Yosemite support. November 22, 2014 change URLs.
Running the OS X FreeSWITCH™ Installer
Make sure to review the one-time Preparation steps first!
One-Time Security Prompts
If OS X is set to disallow Apps that are not from an identified developer you must open System Preferences –> Security & Privacy and under General set "Allow apps download from anywhere".
There is a one-time security prompt due to OS X's tight security because the script automates one keystroke (command-K in Terminal). The first time it is run OS X's will open System Preferences –> Security & Privacy and under Privacy unlock the lock and authorize AppleScript and/or the installer to allow this capability. This only occurs once.
Double-click the installer to start it. Just follow the prompts and answer a few questions!
You can perform other functions while the installer is running, just be careful not to type into a Terminal command issued by the installer.
Installation is Complete!