This page describes basic testing and diagnostics of FreeSWITCH™ on macOS. It is part of the FreeSWITCH™ macOS documentation.

Testing FreeSWITCH

Before testing FreeSWITCH™ verify that the installation was completed normally. If using macFI open the installation log folder on the desktop then open the "make" log and scroll to the bottom. If there are errors they must be resolved. If you performed a manual installation each step should have been checked before proceeding to the next step.

Startup FreeSWITCH

Regardless of how FreeSWITCH™ was installed it can be started from the command line or from macFI by selecting the "Test FreeSWITCH" option.

Startup From the Command Line

Start FreeSWITCH™ in a Terminal window using these commands:

  cd /usr/local/freeswitch/bin

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:

  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 Desktop or Bria for iPhone, or search the macOS App Store for "SIP" for a free download of Telephone. Then follow these steps:

Test Two Phones

To establish a connection between phones, a second phone must be setup as follows:

Test Additional Phones

User IDs 1000-1019 with password 1234 are pre-configured so up to 20 phones can be tested. To experience the potential of FreeSWITCH™ perform some functions found in Test Calls.

Shutdown FreeSWITCH™

Issue the following command in the FreeSWITCH™ Terminal window:



What Next?

Once FreeSWITCH™ has been tested it's time to customize macOS. The macOS Customization instructions will keep you busy!

Diagnosing Problems

If there is a problem you may need to provide diagnostic information to the developers. For instance, to see if your phones are registered during testing using the following command:

sofia status profile internal reg

FreeSWITCH™ Diagnostic Tools

There is a limited Troubleshooting Freeswitch and Troubleshooting Debugging information page available on the wiki. However, if you report a problem you will be asked for traces and log options. It will help to have them in advance if possible so you should become familiar with some of the following debugging commands:

   log 7
   console loglevel debug
   sofia loglevel all 9
   sofia profile profname(external..) siptrace on/off
   sofia status [profilename}
   sofia global siptrace on
   sofia reload
   sofia profile <name> restart
   nat_map status
   nat_map reinit
   fsctl debug_level 1

   fsctl send_sighup    # <- To force the freeswitch.log file to segment.


TCP and SIP Diagnostic Tools

You may be asked for traces of the actual network data on the lan connection. The most common tools for this purpose are:

macOS Diagnostic Tools

All of these tools are supplied with macOS.

To terminate press control+z.