Call Us Today! 877.742.2583




Page tree

Versions Compared

Key

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

About

This section page describes the process of installing and performing basic testing of FreeSWITCH™ and its prerequisites on macOS 10.12, OS X 10.11, and 10.10. Instructions for older releases are located at the Mac OS X Archive.FreeSWITCH™ installation methods available for the macOS releases below. It is part of the FreeSWITCH™ macOS documentation.
 ---

Panel
bgColor#f8f8f8

Table of Contents
outlinetrue
excludeAbout
stylenone

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.

Testing History

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

...

Section


Column
width6%2%

 



1.6.15+git~20170309 Production
Column
width50%65%

                                                    macOS FreeSWITCH™ Testing HistoryStatus

Release
macOSTested
Xcode
FreeSWITCH™
Version
 V.R.M*Status

Monterey

10.

12.

3 Sierra

March 9, 2017

 February 4, 2017

8.2.1

4

October 25, 2021

June 29, 2022

1.10.7 Current Public Release

1.

9.0+git~20170204 Master Development

Good

Good

  10.11.6 El Capitan

March 4, 2017

March 4, 2017

7.3.1

1.6.15+git~20170303 Production Release

1.9.0+git~20170304 Master Development

Good

Good

  10.10.5 Yosemite

March 4, 2017

March 4, 2017

7.2.1

1.6.15+git~20170303 Production Release

1.9.0+git~20170304 Master Development

Good

Good

 

 

Backup!

This procedure installs a significant amount of software, all of it can be removed. However, some of the Apple Command Line Tools, part of Xcode may remain. There is no problem leaving these small parts installed, but to restore to a point where nothing was installed a backup is required before starting this procedure.

 

 

Warning
titleWarning - Very Old Upgraded Systems

Upgraded macOS or Xcode?
Upgraded systems that originally contained 10.7 Lion or older, or Xcode version 4 or older, will likely have significant problems.

Prerequisites Previously Installed Differently?

If prerequisites were previously installed using methods other than described here, there may be problems.

Installation Methods

Installation of FreeSWITCH™ on macOS can be performed using the macOS FreeSWITCH™ Installer (macFI), or manually.

macOS FreeSWITCH™ Installer (macFI)

The macOS FreeSWITCH™ Installer is the recommended method since it simplifies installation by automating all of the manual steps. Aside from being much faster, other advantages include renaming existing FreeSWITCH™ directories before installation, and creating installation logs. The macFI can be downloaded at macOS macFI Installation.

Tip

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

Manual Installation

A manual installation involves downloading and installing Xcode, prerequisites and FreeSWITCH™ by entering commands into the Terminal application.

10.8 20220629 Development

Bad #1367#1474#1497

Good

Big Sur
11.6

November 25, 2021

June 18, 2022

1.10.7 Current Public Release

1.10.8 20220616 Development

Bad #1367#1474#1497

Good

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

Tip

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.



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

Disadvantages

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


...