Call Us Today! 877.742.2583

Page tree
Skip to end of metadata
Go to start of metadata


The FreeSWITCH core configuration is contained in autoload_configs/switch.conf.xml

 Click here to expand Table of Contents

Default key bindings

Function keys can be mapped to API commands using the following configuration:

<key name="[1-12]" value="[api command]"/>

The default keybindings are;

F1 = help
F2 = status
F3 = show channels
F4 = show calls
F5 = sofia status
F6 = reloadxml
F7 = console loglevel 0
F8 = console loglevel 7
F9 = sofia status profile internal
F10 = sofia profile internal siptrace on
F11 = sofia profile internal siptrace off
F12 = version

Beware that the option loglevel is actually setting the minimum hard_log_Level in the application. What this means is if you set this to something other than DEBUG no matter what log level you set the console to one you start up you will not be able to get any log messages below the level you set. Also be careful of mis-typing a log level, if the log level is not correct it will default to a hard_log_level of 0. This means that virtually no log messages will show up anywhere.

Core parameters


Allows to use ODBC database instead of sqlite3 for freeswitch core.




Maximum number of simultaneous DB handles open


Maximum number of seconds to wait for a new DB handle before failing


(bool) disables monotonic timer/clock support if it is broken on your system.


Enables FreeSWITCH to use system time.

After discussion withe the engineers, I've come to understand that the "enable-use-system-time" parameter is a work around for older machines with broken clock api's.

It's not recommended to use this setting in modern machines, as it's likely to break timing and other things... more notably when it comes to CDR's...
It's preferred to use monotonic timing like as NTP/UTC...

I hear it can be useful to use non-monotonic timing for debugging weird issues occasionally, but I dont have specifics how/when that may be used.
Using montonic timing is exactly how you address clock shift issues.

enable-use-system-time is something that may get removed from source code at some point, we've just not taken the time to remove it yet...


Number of event dispatch threads to allocate in the core. Default is 1.

If you see the WARNING "Create additional event dispatch thread" on a heavily loaded server, you could increase the number of threads to prevent the system from falling behind.

The maximum value is runtime.cpu_count / 2


amount of detail to show in log


limits the total number of concurrent channels on your FreeSWITCH™ system.


throttling mechanism, the switch will only create this many channels at most, per second.


RTP port range begin


RTP port range end


Adds timestamps to dialplan log lines (useful for log correlation and other stats).

<param name="dialplan-timestamps" value="true"/>

Example of info added:

UUID 2016-11-18 11:05:53.309812 [DEBUG] mod_dialplan_xml.c:690 Dialplan: LOGDATA


Variables are default channel variables set on each channel automatically.

Example config

<configuration name="switch.conf" description="Modules">
    <!--Most channels to allow at once -->
    <param name="max-sessions" value="1000"/>
    <param name="sessions-per-second" value="30"/>
    <param name="loglevel" value="debug"/>

    <!-- Maximum number of simultaneous DB handles open -->
    <param name="max-db-handles" value="50"/>
    <!-- Maximum number of seconds to wait for a new DB handle before failing -->
    <param name="db-handle-timeout" value="10"/>

  <!--Any variables defined here will be available in every channel, in the dialplan etc -->
    <variable name="uk-ring" value="%(400,200,400,450);%(400,2200,400,450)"/>
    <variable name="us-ring" value="%(2000, 4000, 440.0, 480.0)"/>
    <variable name="bong-ring" value="v=4000;>=0;+=2;#(60,0);v=2000;%(940,0,350,440)"/>


  1. The command reloadxml can reload this xml conf at a running freeswitch server ?

  2. For many parameters, you'll have to use fsctl, for example,  fsctl max_sessions 10000 or fsctl sps 1000 for sessions per seconds.