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 ArchiveFreeSWITCH™ 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

Testing

...

Status

Info
titleWeekly Testing Suspended Since August 2021

Weekly testing of the FreeSwitch Master Development version is suspended due to build errors since August 1 2021.

macOS testing was performed

...

only on Intel Macs, M1 Arm testing may begin if macOS building resumes. 

All macOS versions are installed into new volumes with the latest Apple Command Line Tools. Upgraded systems are never used.

 

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

...

Section


Column
width6%2%

 



Column
width50%65%

                                                    macOS FreeSWITCH™ Testing HistoryStatus

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

Monterey
12.3

Sierra


March 9

October 25,

2017

 February 4, 2017

8.2.1

2021

May 8, 2022

1.

6.15+git~20170309 Production

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

 

 

Preparation

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.

Terminal Application Preferences

The Terminal application is used extensively during installation, and to start FreeSWITCH™. The following changes are recommended to save time:

  1. Copy Terminal in the Applications/Utilities folder into the Dock for quick access.
  2. Start the Terminal application by clicking it in the dock. Then open its preferences panel.
  3. In Settings–>Profiles–>Window change the Window Size to larger values such as 140x48 to reduce having to resize the window often.
  4. In Settings–>Profiles–>Window set Scrollback to "Limit to Available Memory" or a larger number. Many messages are produced that may be needed for problem analysis.
  5. In Settings–>Profiles–>Shell set Prompt before closing to "Only if there are processes other than:". This prevents the Terminal window from closing when FreeSWITCH™ is shutdown if it started automatically, which would result in the loss of all messages in the window. This is useful during debugging. If FreeSWITCH™ started manually the window does not close.

 

10.8 20220414 Development

Bad  #1367#1474#1497#1500

Bad #1474#1500#1560#1648

Big Sur
11.6

November 25, 2021

November 25, 2021

1.10.7 Current Public Release

1.10.8 20211123 Development

Bad #1367#1474#1497#1500

Bad #1474#1500 #1560, #1648

* Version.Release.Maintenance-Level



History for older releases is at the macOS Archive.

...

Installation Methods

FreeSWITCH™ installation on macOS is performed manually, by the macFI installer utility or from Homebrew.

Homebrew Installation

This is the easiest method to install FreeSWITCH™ and is a good way to get the feel of FreeSWITCH with the least time and effort. The disadvantages are that it can only install the current production version and is very limited because additional modules cannot be easily built if they are not part of the default set.

To perform a Homebrew installation use the macOS Homebrew Installation instructions.

Tip

Until further notice, this is the ONLY WAY to install FreeSWITCH on macOS. See Status above.



macOS FreeSWITCH™ Installer (macFI)

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

Tip

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



Manual Installation

A manual installation involves downloading and installing Xcode, prerequisites and FreeSWITCH™ by entering commands into the Terminal applicationrequires use of the Terminal application to enter commands to setup directories, install prerequisites and FreeSWITCH™.

To perform a manual installation use the macOS Manual Installation instructions, 

...