Command line

From FreeSWITCH Wiki
Jump to: navigation, search



The options available may differ, depending on the operating system. Use the following command to see what is available.

/usr/local/freeswitch/bin/freeswitch -help 

In addition to using the command line, options may also be set with the FREESWITCH_OPTS environment variable.

Arguments List

Informational Tip

These are the optional arguments you can pass to freeswitch:

       -waste                 -- allow memory waste
       -no-auto-stack         -- don't adjust thread stack size
       -core                  -- dump cores
       -help                  -- print this message
       -version               -- print the version and exit
       -rp                    -- enable high(realtime) priority settings
       -lp                    -- enable low priority settings
       -np                    -- enable normal priority settings (system default)
       -vg                    -- run under valgrind
       -nosql                 -- disable internal SQL scoreboard
       -heavy-timer           -- Heavy Timer, possibly more accurate but at a cost
       -nonat                 -- disable auto NAT detection
       -nonatmap              -- disable auto NAT port mapping
       -nocal                 -- disable clock calibration
       -nort                  -- disable clock clock_realtime
       -stop                  -- stop freeswitch
       -nc                    -- no console and run in background
       -ncwait                -- no console and run in background, but wait until the system is ready before exiting (implies -nc)
       -c                     -- output to a console and stay in the foreground (default behavior)
       UNIX-like only
       -nf                    -- no forking
       -u [user]              -- specify user to switch to
       -g [group]             -- specify group to switch to
       -ncwait                -- do not output to a console and background but wait until the system is ready before exiting (implies -nc)
       -service [name]        -- start freeswitch as a service, cannot be used if loaded as a console app
       -install [name]        -- install freeswitch as a service, with optional service name
       -uninstall             -- remove freeswitch as a service
       -monotonic-clock       -- use monotonic clock as timer source
       Options to control locations of files:
       -base [basedir]         -- alternate prefix directory
       -conf [confdir]         -- alternate directory for FreeSWITCH configuration files
       -log [logdir]           -- alternate directory for logfiles
       -run [rundir]           -- alternate directory for runtime files
       -db [dbdir]             -- alternate directory for the internal database
       -mod [moddir]           -- alternate directory for modules
       -htdocs [htdocsdir]     -- alternate directory for htdocs
       -scripts [scriptsdir]   -- alternate directory for scripts
       -temp [directory]       -- alternate directory for temporary files
       -grammar [directory]    -- alternate directory for grammar files
       -recordings [directory] -- alternate directory for recordings
       -storage [directory]    -- alternate directory for voicemail storage
       -sounds [directory]     -- alternate directory for sound files


Note: if you set any of -conf, -log, and -db you must set all three.

Arguments Details

Setting some arguments may affect behavior in unexpected ways. The following list contains known side-effects of setting various command line arguments.

  • nosql - Setting nosql completely disables the use of coreDB which means you will not have show channels, show calls, tab completion, or anything else that is stored in the coreDB.

See Also