Call Us Today! 877.742.2583

Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


What Can the macOS FreeSWITCH™ Installer (macFI) do?

  • Install FreeSWITCH™ 1.6 the latest production or master/development from source on macOS 10.13 High Sierra, 10.12 Sierra, 10.11 El Capitan, 10.10 Yosemite and .
  • Install FreeSWITCH™ the latest production or master/development from source on OS X 10.9 Mavericks in unsupported mode (no future fixes to macFI).
  • Start FreeSWITCH™ for testing.
  • Update FreeSWITCH™.
  • Remove parts or all of the installation.
  • Show and hide macOS invisible files.
  • Open wiki pages,


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


Where to go Next

 Instructions for starting and stopping FreeSWITCH™ are at macOS Testing and Diagnostics.



macFI Change History

July 13, 2017              Major update: No longer requires update for release changes, current stable lookup, place VRM in messages, add stable branch download, add unsupported message

June 24, 2017            Change /usr/local logic for 10.13 and compatibility, add show/hide invisible files, redo intro dialogs and wiki options, add update function
March 24, 2017          Added libtiff prerequisite for spandsp.
January 4, 2017         Added speexdsp prerequisite.
September 15, 2016  Renamed, change path for new Homebrew, use active Xcode version, 10.11 get Xcode 7 from dev site. Sep 16/17 Update Xcode URLs
July 17, 2016             Add testing only option, 10.10 get Xcode 7 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.
April 5, 2014             First released to the Wiki