Skip to main content

macOS Installation


This page describes FreeSWITCH™ installation methods available for the macOS releases below. It is part of the FreeSWITCH™ macOS documentation.

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.

macOS FreeSWITCH™ Status

macOSTestedFreeSWITCH™ V.R.M*Status
Ventura13.1December 15, 2022December 15, 20221.10.8 Current Public Release1.10.9 20221208 DevelopmentGoodBad #1840
Monterey12.6October 14, 2022October 25, 20221.10.8 Current Public Release1.10.9 20221024 DevelopmentGoodBad #1840

* 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.
  • Information on this wiki is limited to testing results since the Homebrew version is maintained independently from this wiki.

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, except faster.

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 release), 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.