Call Us Today! 877.742.2583

Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 37 Next »


This is part of the Installation and Testing on OS X guide for installing and running FreeSWITCH™. This page describes the installation of FreeSWITCH™ using the macOS FreeSWITCH™ Installer (MFI) that automates installation steps.xx


What Does it Do?

The installer installs FreeSWITCH™ 1.6 or FreeSWITCH™ master/development from source on macOS 10.12, OS X 10.11 El Capitan, 10.10 Yosemite and 10.9 Mavericks systems. Support for older systems are dropped as instructions for those systems are archived.

Why Use the macOS FreeSWITCH™ Installer (MFI)?

There are lot's of advantages to using the MFI as seen below. The primary ones are:

  • It eliminates the need to use Terminal commands and guides people 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 a lot of time during initial installation, updates and testing. In fact, this wiki takes a lot of testing to update, I developed this so I could click a couple of times then walk away!

What Steps are Performed?

The installer performs identical steps as described in Manual InstallationYou can review the manual instructions before using the MFI to view most of the commands the MFI will execute.

Here is the sequence of functions performed:

  1. Determines if it can run on the OS X release.
  2. Asks what function is desired, install, test or remove.
  3. For installation, what version to download.
  4. Checks for presence of Xcode and Xcode beta.
  5. Checks for presence of Command Line Utilities.
  6. Checks if hidden files are visible.
  7. Checks if the required directories exists.
  8. Checks if the install directory has the correct ownership.
  9. Checks for presence of Homebrew.
  10. Checks for presence of prerequisites supplied by Homebrew.
  11. Checks for presence of previous FreeSWITCH™ source and runtime libraries.
  12. Produces a list of actions to take and requests verification to proceed.
  13. If required, launches web pages to install Xcode.
  14. If required, launches functions to install Command Line Utilities.
  15. If required, makes hidden files visible.
  16. If required, creates directories exists.
  17. If required, changes the ownership of the install directory.
  18. If required, downloads and installs Homebrew.
  19. If required, updates prerequisites supplied by Homebrew.
  20. If required, downloads and installs prerequisites supplied by Homebrew.
  21. If required, renames previous FreeSWITCH™ source and runtime libraries to prevent changes.
  22. Performs git clone of FreeSWITCH™.
  23. Performs bootstrap and configure.
  24. Adds FLITE to modules.conf.
  25. Performs make, make install, make install sounds, and make clean.
  26. Prompts for testing selection.
  27. If testing, opens web pages to FreeSWITCH™ information and displays IP address and port for phone configuration.
  28. If testing, launches FreeSWITCH™ to test.


Still not convinced to use the MFI? 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 or update Homebrew
  • Install and/or update prerequisites
  • Download and install FreeSWITCH™ source
  • bootstrap command
  • configure command
  • make command
  • make install command
  • make install sounds command
  • make clean


Installing the macOS FreeSWITCH™ Installer

It's incredibly easy to install, just follow this single step:

  1. Click on this link: macOS FreeSWITCH™ Installer, OS X will automatically download and unzip the file.

    Installer history:

    July 17, 2016            Add testing only option, change 10.10 to request xcode from dev site, use Xcode beta if found, allow bypass of open test calls wiki. Minor fixes.

    February 26, 2016    Remove libvpx libyuv, replace nasm with yasm, change remove brew cache command.
    November 26, 2015  Replace non-homebrew packages with homebrew since they are now available.
    October 22, 2015     List names of prereqs. Other minor fixes.
    October 16, 2015     Add FreeSWITCH™1.6, remove 1.4, update prerequisites add installation of non-homebrew packages.
    October 3, 2015       Add change ownership logic for /usr/local, change 10.9 Xcode 6 download, remove 10.8 and Xcode 5 support.
    November 5, 2014   Add Xcode 6.1 and Yosemite support. November 22, 2014 change URLs.

Running the macOS 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 MFI 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 should not perform other functions while the installer is running, although the installer will run correctly, the Terminal window may not display as intended.

You can rerun the installer anytime, even it it was stopped or failed. It will determine what is already installed.


Where to go Next

Instructions for starting and stopping FreeSWITCH™ are at Installation and Testing on OS X - Startup From Command Line.


  • No labels