You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/FreeSWITCH-Explained/Installation/macOS/index.mdx
+4-3Lines changed: 4 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -4,13 +4,13 @@
4
4
5
5
## About
6
6
7
-
This is a complete guide for installing FreeSWITCH™ and its prerequisites on macOS, and for establishing 24x7 operation.
7
+
This is a complete guide for installing FreeSWITCH™ on macOS, and for establishing 24x7 operation.
8
8
9
9
****What Is FreeSWITCH™?**
10
10
**[FreeSWITCH™](http://en.wikipedia.org/wiki/FreeSWITCH)** is an **[application](https://en.wikipedia.org/wiki/Application%5Fsoftware)** that manages **[VOIP](http://en.wikipedia.org/wiki/Voip)** phones and connections to **[ITSPs (Internet Telephony Service Providers)](http://en.wikipedia.org/wiki/ITSP).**
11
11
12
12
**What Can You Do With FreeSWITCH™?**
13
-
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!
13
+
It's powerful customization provides our system to do this: Incoming callers 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!
14
14
15
15
**Who Are These Pages For?**
16
16
This document is for people who want to install FreeSWITCH™ on macOS and are not familiar with Linux/Unix commands and directories.
@@ -20,7 +20,7 @@ Here is a list of the macOS Wiki pages:
| Manual installation using Terminal |[macOS Manual Installation](./macOS-Installation/macOS-Manual-Installation_13174557.mdx#about)|
26
26
| Install Homebrew FreeSWITCH version |[macOS Homebrew Installation](./macOS-Installation/macOS-Homebrew-Installation_72253508.mdx#about)|
@@ -43,6 +43,7 @@ FreeSWITCH™ is tested and runs 24x7 on a [headless](macOS-Customization_963451
43
43
**macOS Wiki History**
44
44
Major changes occurred:
45
45
46
+
* June 19, 2025 - All pages updated to add Apple Silicon information
46
47
* May 14, 2022 - Created "macOS Homebrew Installation" page
47
48
* March 12, 2017 - Created "Manual Installation", "Testing and Diagnosis", "24x7 Preparation", "Email Voicemails" split from other pages
48
49
* 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
Copy file name to clipboardExpand all lines: docs/FreeSWITCH-Explained/Installation/macOS/macOS-24x7-Preparation_13174585.mdx
+35-13Lines changed: 35 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,8 @@
1
-
2
1
# macOS 24x7 Preparation
3
2
4
-
5
3
## About
6
4
7
-
This section describes how to prepare macOS for running FreeSWITCH™ 24x7\. It is part of the FreeSWITCH™ [macOS](./index.mdx#about) documentation.
5
+
This section describes how to prepare macOS for running [FreeSWITCH](https://en.wikipedia.org/wiki/FreeSWITCH)™ 24x7\. It is part of the FreeSWITCH™ [macOS](./index.mdx#about) documentation.
@@ -45,11 +43,13 @@ You can perform all editing using Textedit, however, you should become familiar
45
43
46
44
Some steps in this section require a command script file. This is a file that you can double click to run in the Terminal application. More importantly, these files are also used for automatic startup functions.
47
45
48
-
Command files are text files containing Terminal commands with the file's permission changed to become executable. Rather than repeat this process for each file, create a dummy command file that will serve as a skeleton and retain its permissions when copied. The files are saved in /usr/local/freeswitch-scripts but you can place them anywhere. Once a command text file is created it can be opened and saved in Textedit or Xcode, whatever is your preference, without any extra steps.
46
+
Command files are text files containing Terminal commands with the file's permission changed to become executable. Rather than repeat this process for each file, create a dummy command file that will serve as a skeleton and retain its permissions when copied. The files are saved in /opt or /usr/local/ but you can place them anywhere. Once a command text file is created it can be opened and saved in Textedit or Xcode, whatever is your preference, without any extra steps.
49
47
50
-
* Create the /usr/local/freeswitch-scripts directory:
48
+
* Create the freeswitch-scripts directory:
51
49
```xml
52
-
mkdir /usr/local/freeswitch-scripts
50
+
mkdir /opt/freeswitch-scripts # On Apple Silicon
51
+
or
52
+
mkdir /usr/local/freeswitch-scripts # On x86
53
53
```
54
54
1. Start Textedit
55
55
2. Paste the two lines below into the empty document:
@@ -62,20 +62,22 @@ Make sure they are saved as text:
62
62
63
63
1. Pull down the Format menu
64
64
2. Select Make Plain Text, if the default for saving text is already Plain Text, this step is not needed.
65
-
3. Save the file in /usr/local/freeswitch-scripts as dummy.command. While the file window is open press command+shift+.(period) to view hidden files.
65
+
3. Save the file in /opt/freeswitch-scripts or /usr/local/freeswitch-scripts as dummy.command. While the file window is open press command+shift+.(period) to view hidden files.
66
66
4. You may see examples with #!/bin/sh as the first line, either will work in any of these scripts.
67
67
68
68
69
69
Start the Terminal application, switch to the new directory and enter the chmod command to make the file executable:
70
70
71
71
```xml
72
-
cd /usr/local/freeswitch-scripts
72
+
cd /opt/freeswitch-scripts # On Apple Silicon
73
+
or
74
+
cd /usr/local/freeswitch-scripts # On x86
73
75
chmod +x dummy.command
74
76
```
75
77
76
78
## Create the FreeSWITCH™ Command Script
77
79
78
-
The command to start FreeSWITCH™ is /usr/local/freeswitch/bin/freeswitch -parm1 -parm2…. You can start the freeswitch program using this command. However, it's much better to use a [bash](http://en.wikipedia.org/wiki/Bash%5F%28Unix%5Fshell%29)[script](http://en.wikipedia.org/wiki/Script%5F%28computing%29) which starts FreeSWITCH™.
80
+
The command to start FreeSWITCH™ is /opt/freeswitch/bin/freeswitch or /usr/local/freeswitch/bin/freeswitch -parm1 -parm2…. You can start the freeswitch program using this command. However, it's much better to use a [bash](http://en.wikipedia.org/wiki/Bash%5F%28Unix%5Fshell%29)[script](http://en.wikipedia.org/wiki/Script%5F%28computing%29) which starts FreeSWITCH™.
79
81
80
82
Consider these requirements for a 24x7 phone system:
@@ -371,6 +381,8 @@ Create the freeswitch-cli.command file in directory freeswitch-scripts:
371
381
Next, add a line containing the command needed to start freeswitch-cli. Edit the new file and add the following line as the second line of the file (between the existing two lines):
372
382
373
383
```xml
384
+
/opt/freeswitch/bin/freeswitch-cli
385
+
or
374
386
/usr/local/freeswitch/bin/freeswitch-cli
375
387
```
376
388
@@ -401,12 +413,14 @@ Start Terminal and enter this command to create the freeswitch-logseg.command fi
401
413
Open the file in the editor and add the following line as the second line of the file (between the existing two lines).
Make sure FreeSWITCH™ is up and double click the file to test it. View the /usr/local/freeswitch/log directory, if the log was segmented proceed with the next steps.
423
+
Make sure FreeSWITCH™ is up and double click the file to test it. View the /opt/freeswitch/log or /usr/local/freeswitch/log directory, if the log was segmented proceed with the next steps.
410
424
411
425
Set Security and Test
412
426
@@ -434,7 +448,9 @@ Next, the plist file Launchd requires is created:
@@ -473,6 +489,8 @@ Start Terminal and enter this command to create the freeswitch-logclr.command fi
473
489
Open the file in the editor and add the following line as the second line of the file (between the existing two lines). Notice that mtime is set so files older than 14 days are deleted. You can change this to any valid mtime value.
Copy file name to clipboardExpand all lines: docs/FreeSWITCH-Explained/Installation/macOS/macOS-Customization_9634513.mdx
+3-5Lines changed: 3 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,9 @@
1
1
2
2
# macOS Customization
3
3
4
-
5
-
6
4
## About
7
5
8
-
This section describes how to customize macOS and FreeSWITCH™ to provide additional benefits. It is part of the FreeSWITCH™ [macOS](./index.mdx#about) documentation.
6
+
This section describes how to customize macOS and [FreeSWITCH](https://en.wikipedia.org/wiki/FreeSWITCH)™ to provide additional benefits. It is part of the FreeSWITCH™ [macOS](./index.mdx#about) documentation.
@@ -22,7 +20,7 @@ This section describes how to customize macOS and FreeSWITCH™ to provide addit
22
20
23
21
## Configuration Introduction
24
22
25
-
Read [Configuring FreeSWITCH](../../Configuration/Configuring-FreeSWITCH/index.mdx#set) to learn about the various configuration files and "poke around" the sample configuration in the /usr/local/freeswitch/conf folder. To setup the gateway to your ITSP and dialplans so you can make and receive calls these files require changing:
23
+
Read [Configuring FreeSWITCH](../../Configuration/Configuring-FreeSWITCH/index.mdx#set) to learn about the various configuration files and "poke around" the sample configuration in the /opt/freeswitch/conf or /usr/local/freeswitch/conf folder. To setup the gateway to your ITSP and dialplans so you can make and receive calls these files require changing:
26
24
27
25
* Gateway to your ITSP in conf/sip\_profiles
28
26
* User extensions in conf/directory/default
@@ -99,7 +97,7 @@ If you have a headless Mac but don't have another one to use for screen or file
99
97
100
98
## Invisible Files and Directories
101
99
102
-
macOS hides many Unix directories and files from the finder and Terminal app. You won't be able to view /usr or other hidden directories without special commands or extra steps. Here are some options to allow you to see hidden files:
100
+
macOS hides many Unix directories and files from the finder and Terminal app. You won't be able to view /opt, /usr or other hidden directories without special commands or extra steps. Here are some options to allow you to see hidden files:
Copy file name to clipboardExpand all lines: docs/FreeSWITCH-Explained/Installation/macOS/macOS-Email-Voicemail_13174591.mdx
+18-10Lines changed: 18 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,8 @@
1
-
2
1
# macOS Email Voicemail
3
2
4
-
5
-
6
3
## About
7
4
8
-
This section describes how to customize macOS and FreeSWITCH™ to send voicemail files as emails automatically. It is part of the FreeSWITCH™ [macOS](./index.mdx#about) documentation.
5
+
This section describes how to customize macOS and [FreeSWITCH](https://en.wikipedia.org/wiki/FreeSWITCH)™ to send voicemail files as emails automatically. It is part of the FreeSWITCH™ [macOS](./index.mdx#about) documentation.
9
6
10
7
* 1 [Email Voicemail to an iPhone](#email-voicemail-to-an-iphone)
11
8
* 2 [How This Works](#how-this-works)
@@ -44,7 +41,7 @@ Before editing files the correct parameters must be determined. The process is n
44
41
45
42
**fromname** - The email account name of fromdomain the email is sent from. The example uses "freeswitch".
46
43
47
-
**frompw**- The password for the fromname email account. The example uses "SECRET".
44
+
**frompw**- The password for the fromname email account. The example uses "SECRET".
48
45
49
46
**toemail** - The target complete email address the email to be sent to. The example uses [email protected].
50
47
@@ -170,10 +167,21 @@ If everyones voicemail are to go to a single common email, you can optionally ma
170
167
171
168
Edit voicemail.xml and change the line below, make sure to use the valid email account used in the passwords file above:
0 commit comments