Skip to main content

macOS Installation

About​

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.

Advantages

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

Disadvantages

  • 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.

Advantages

  • 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.

Disadvantages

  • 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.

Advantages

  • 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.

Disadvantages

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