Call Us Today! 877.742.2583

Page tree

Versions Compared


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


This is the home page of the sections that describe installing and performing basic testing of FreeSWITCH™ and its prerequisites on OS X. page describes FreeSWITCH™ installation methods available for the macOS releases below. It is part of the FreeSWITCH™ macOS documentation.



Table of Contents


If you have not read the Mac OS X page please view it now.

Warnings About Upgraded Systems

In some cases older upgraded systems had issues due to old parts of a prior OS X or Xcode still intact. In these cases a fresh OS X and Xcode install may required.--

 Upgraded OS X Systems

titleUpgraded OS X?

Most upgraded OS X systems will work depending on the level of the oldest original system. Some very old upgraded systems may have problems due to old files left in various directories. 

If there are problems installing prerequisites check if OS X was upgraded from a very old release, for instance 10.6 or 10.7. The older the original system the more likely problems will occur.


 Upgraded Xcode

titleUpgraded Xcode?

Most upgraded Xcode systems will work depending on the level of the oldest original Xcode. Some very old upgraded Xcode systems may have problems due to old files left in various directories.

If there are problems installing prerequisites check if Xcode was upgraded from a very old release, for instance 3 or 4. The older the original system the more likely problems will occur.



 Previously Installed Prerequisites

titlePrerequisites Previously Installed Differently?

If prerequisites were previously installed using different methods and there are problems, you should build OS X from scratch. In tests, using Homebrew or the script below worked every time on freshly installed OS X systems.




Installation of FreeSWITCH™ on OS X can be performed using the AppleScript installer, or manually.

AppleScript Installation

The OS X FreeSWITCH™ Installer simplifies installation of FreeSWITCH™ on OS X by automating the all of the manual steps, except for prompting for an administrator password. It creates logs that are useful in case of problems. The installer can be downloaded at Installation on OS X using AppleScript.

titleThe OS X FreeSWITCH™ Installer

Even if you use the OS X FreeSWITCH™ Installer it's a good idea to read the manual instructions so you know what the installer will adding to the system.

 The installer is only available for OS X10.9 or later.

Manual Installation




Select OS X Release


Installation Methods

FreeSWITCH™ installation on macOS is performed using one of these methods:

  • Homebrew, the fastest method to get started. Apple Silicon version available.
  • The macFI installer utility, identical to manual but faster and with installation logs.
  • Manually, if you want to build from source and know every detail of the installation.

Build and Testing Status

This status does not apply to the Homebrew version. Testing is performed on Intel Macs with macOS and the latest Apple Command Line Tools installed into new volumes.





                                      FreeSWITCH™ OS X Release               macOS FreeSWITCH™ Status

Installation Wiki Page
  10.11.0 El Capitan  October 3, 2015  Installation on OS X 10.11 El Capitan
  10.10.5 Yosemite  October 3, 2015  

Installation on OS X 10.10 Yosemite 

  10.9.5 Mavericks  October 3, 2015  Installation on OS X 10.9 Mavericks
  Mac OS X Archive Mac OS X Archive 


Installation is Complete

This section is used to allow the previous pages to return to this location. Do not remove this section.


Test FreeSWITCH™!

Startup From the Command Line

The time has come to start FreeSWITCH™ in a Terminal window:

Code Block
  cd /usr/local/freeswitch/bin

There are many startup messages ending with some text boxes containing the names of the developers.

Test the FreeSWITCH™ Command Prompt

After all startup messages are displayed a command prompt appears, messages may continue as the prompt remains. Try a few FreeSWITCH™ commands:

Code Block
  sofia status

If the commands return responses FreeSWITCH™ is working and you can continue with the next step.

Test A Phone

Test using a physical SIP phone or soft phone such as Bria, or search the OS X App Store for "SIP" for a free download of Telephone. Setup the phone using the IP address of the Mac FreeSWITCH™ is running on. The port is 5060, user IDs 1000-1019 with a password of 1234 are pre-configured. Additional information is at Test CallsTest as many functions as you can to experience the potential of FreeSWITCH™.

Shutdown FreeSWITCH™

Issue the following command in the FreeSWITCH™ Terminal window:

Code Block


FreeSWITCH™  V.R.M*Status


October 25, 2021

June 29, 2022

1.10.7 Current Public Release

1.10.8 20220629 Development

Bad #1367#1474#1497


Big Sur

November 25, 2021

June 18, 2022

1.10.7 Current Public Release

1.10.8 20220616 Development

Bad #1367#1474#1497


* Version.Release.Maintenance-Level

History for older releases is at the macOS Archive.


Homebrew Installation

This is the easiest and fastest way to install FreeSWITCH on macOS. To perform a Homebrew installation use the macOS Homebrew Installation instructions.


  • Easiest method to install FreeSWITCH™.
  • Apple Silicon and Intel versions available.
  • Support for the last three macOS versions.
  • Utilizes the least disk space.


  • Is provided as a runtime only version, so building optional modules from source is difficult but not usually required.
  • Only provides the current production version.
  • Is maintained independently from this wiki with very limited information. The information on this wiki is from testing the Homebrew version.

macOS FreeSWITCH Installer (macFI)


The macOS FreeSWITCH™ Installer performs identical functions as a manual installation with additions such as logging.

The macOS FreeSWITCH™ Installer automates all of the manual steps, providing much simpler and faster installation. The macFI information and download is located at macOS macFI Installation.


  • The same as manual installation below.
  • Much faster than manual installation performing identical steps.
  • Auto renaming existing FreeSWITCH™ directories before installation to preserve them.
  • Creation of logs for each installation step.


  • The same as manual installation below.

Manual Installation

A manual installation requires use of macOS Terminal to enter commands, setup directories, install prerequisites and FreeSWITCH™. To perform a manual installation use the macOS Manual Installation instructions.


  • Provides access to current release, master (next test version), and updated current FreeSWITCH versions.
  • Building from source provides adding optional modules easily.
  • Testing is performed for this wiki so information is extensive.


  • Longest method to install FreeSWITCH™.
  • Utilizes more disk space than the Homebrew version.
  • No Apple Silicon testing for now.