Skip to main content

macOS

About

This is a complete guide for installing FreeSWITCH™ and its prerequisites on macOS, and for establishing 24x7 operation.

**What Is FreeSWITCH™? FreeSWITCH™ is an application that manages VOIP phones and connections to ITSPs (Internet Telephony Service Providers).

What Can You Do With FreeSWITCH™? It's powerful customization provides our incoming calls to do this: Normal ringing is replaced by: “Hi Pam, hold on while our phones ring", phones ring and Pam hears music, after 25 seconds: “hold on Pam while our iPhones ring", internal phones keep ringing and multiple iPhones ring, if no answer: “sorry we missed you Pam, please leave a message", Pam’s voicemail is taken and emailed to multiple iPhones!

Who Are These Pages For? This document is for people who want to install FreeSWITCH™ on macOS and are not familiar with Linux/Unix commands and directories.

What Is Available on the FreeSWITCH™ macOS Wiki? Here is a list of the macOS Wiki pages:

DescriptionPage
FreeSWITCH™ macOS Installation optionsmacOS Installation
Automated installation utilitymacOS macFI Installation
Manual installation using TerminalmacOS Manual Installation
Install Homebrew FreeSWITCH versionmacOS Homebrew Installation
Basic testing and diagnosing problemsmacOS Testing and Diagnostics
Customization, tips and screen sharingmacOS Customization
24x7 operation and automatic restartmacOS 24x7 Preparation
Email voicemail files to an iPhonemacOS Email Voicemail
Archive since 2010 starting with OS X 10.6MacOS Archive

How This Documentation Was Developed and Maintained FreeSWITCH™ is tested and runs 24x7 on a headless Mac Mini. There was almost no FreeSWITCH™/macOS information when I replaced a VOIP PBX in 2010. So I compiled what I learned through searching, trial and error, the FreeSWITCH™ mailing list, etc. and created this documentation.

Mario G


macOS Wiki History Major changes occurred:

  • May 14, 2022 - Created "macOS Homebrew Installation" page
  • March 12, 2017 - Created "Manual Installation", "Testing and Diagnosis", "24x7 Preparation", "Email Voicemails" split from other pages
  • October 18, 2015 - Split installation and customization pages, combine installation sections, updated for FreeSWITCH™ 1.6, OS X 10.11 and Xcode 7, archive OS X 10.6, 10.7 and 10.8
  • April 28, 2014 - Major updates for new OS X releases and Xcode
  • Mar 21, 2013 - extensively updated and split into multiple pages
  • Nov 22, 2010 - Created initial documentation