Call Us Today! 877.742.2583




Page tree

Versions Compared

Key

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

About

This is the home page of the sections that describe installing and performing basic testing of FreeSWITCH™ and its prerequisites on OS X. page describes 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

Introduction

If you have not read the Mac OS X page please view it now.

Warnings About Upgraded Systems

Upgraded OS X Systems

 

Warning
titleUpgraded OS X or Xcode ?

All testing for these instructions was performed on a clean/non-upgraded OS X and Xcode system, without issues. Most upgraded OS X or Xcode systems will work depending on the level of the oldest software. Some upgraded systems had problems due to old files left in different directories. 

If there are problems installing prerequisites check if the OS X release was upgraded, for instance from 10.7 or 10.8 to a newer system. The older the original system the more likely problems will occur.

Also check if Xcode was upgraded, for instance from Xcode 4 or 5 to a newer Xcode. The older the original Xcode the more likely problems will occur.

In some cases older upgraded systems had issues due to old parts of a prior OS X or Xcode still intact. In these cases a fresh OS X and Xcode install may required.

Upgraded Xcode

Warning
titlePrerequisites Previously Installed Differently?
If prerequisites were previously installed using different methods and there are problems, you should build OS X from scratch. In tests, using Homebrew or the script below worked every time on freshly installed OS X systems.

Installation

Installation of FreeSWITCH™ on OS X can be performed using the AppleScript installer, or manually.

AppleScript Installation

The OS X FreeSWITCH™ Installer simplifies installation of FreeSWITCH™ on OS X by automating the all of the manual steps, except for prompting for an administrator password. It creates logs that are useful in case of problems. The installer can be downloaded at Installation on OS X using AppleScript.

Tip
titleThe OS X FreeSWITCH™ Installer

Even if you use the OS X FreeSWITCH™ Installer it's a good idea to read the manual instructions so you know what the installer will adding to the system.

 The installer is only available for OS X10.9 or later.

Manual Installation

 

Installation

Select OS X Release

To manually install FreeSWITCH™ on OS X, click a link below to view instructions. The pages link back here to continue.

...

Column
width8%

 

...

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.

Section


Column
width2%



Code Block
shutdown
Column
width65%

                                      FreeSWITCH™ OS X Release               macOS FreeSWITCH™ Testing Status

Release
macOSTested
Installation Wiki Page
  10.11.0 El Capitan  October 3, 2015  Installation on OS X 10.11 El Capitan
  10.10.5 Yosemite  October 3, 2015  

Installation on OS X 10.10 Yosemite 

  10.9.5 Mavericks  October 3, 2015  Installation on OS X 10.9 Mavericks
  Mac OS X Archive Mac OS X Archive 

xxx 

Installation is Complete

This section is used to allow the previous pages to return to this location. Do not remove this section.

 

Test FreeSWITCH™!

Startup From the Command Line

The time has come to start FreeSWITCH™ in a Terminal window:

Code Block
  cd /usr/local/freeswitch/bin
  ./freeswitch

There are many startup messages ending with some text boxes containing the names of the developers.

Test the FreeSWITCH™ Command Prompt

After all startup messages are displayed a command prompt appears, messages may continue as the prompt remains. Try a few FreeSWITCH™ commands:

Code Block
  version
  status
  sofia status

If the commands return responses FreeSWITCH™ is working and you can continue with the next step.

Test A Phone

Test using a physical SIP phone or soft phone such as Bria, or search the OS X App Store for "SIP" for a free download of Telephone. Setup the phone using the IP address of the Mac FreeSWITCH™ is running on. The port is 5060, user IDs 1000-1019 with a password of 1234 are pre-configured. Additional information is at Test CallsTest as many functions as you can to experience the potential of FreeSWITCH™.

Shutdown FreeSWITCH™

Issue the following command in the FreeSWITCH™ Terminal window:

FreeSWITCH™  V.R.M*Status

Monterey
12.3

October 25, 2021

May 8, 2022

1.10.7 Current Public Release

1.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 because it automates all of the manual steps, providing much simpler and faster installation. Other advantages include renaming existing FreeSWITCH™ directories before installation, and creating installation logs. The macFI information and download is located at macOS macFI Installation.

Tip

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



Manual Installation

A manual installation requires 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,

...