The asterisk.conf file defines the
locations for the configuration files, the spool directory, and the
modules, as well as a location to write logfiles to. The default settings
are recommended unless you understand the implications of changing them.
The asterisk.conf file is generated automatically
when you run the make samples
command,
based on information it collects about your system. It will contain a
[directories]
section such as the
following:
[directories] astetcdir => /etc/asterisk astmoddir => /usr/lib/asterisk/modules astvarlibdir => /var/lib/asterisk astdatadir => /var/lib/asterisk astagidir => /var/lib/asterisk/agi-bin astspooldir => /var/spool/asterisk astrundir => /var/run astlogdir => /var/log/asterisk
Additionally, you can specify an [options]
section, which will allow you to
define startup options (command-line switches) in the configuration file.
The following example shows the available options and the command-line
switches that they effectively enforce:
[options] ;Under "options" you can enter configuration options ;that you also can set with command line options verbose = 0 ; Verbosity level for logging (-v) debug = 3 ; Debug: "No" or value (1-4) nofork=yes | no ; Background execution disabled (-f) alwaysfork=yes | no ; Always background, even with -v or -d (-F) console= yes | no ; Console mode (-c) highpriority = yes | no ; Execute with high priority (-p) initcrypto = yes | no ; Initialize crypto at startup (-i) nocolor = yes | no ; Disable ANSI colors (-n) dumpcore = yes | no ; Dump core on failure (-g) quiet = yes | no ; Run quietly (-q) timestamp = yes | no ; Force timestamping in CLI verbose output (-T) runuser = asterisk ; User to run asterisk as (-U) NOTE: will require changes to ; directory and device permissions rungroup = asterisk ; Group to run asterisk as (-G) internal_timing = yes | no ; Enable internal timing support (-I) ; These options have no command line equivalent cache_record_files = yes | no ; Cache record() files in another directory until ; completion record_cache_dir = <dir> transcode_via_sln = yes | no ; Build transcode paths via SLINEAR transmit_silence_during_record = yes | no ; send SLINEAR silence while channel is ; being recorded maxload = 1.0 ; The maximum load average we accept calls for maxcalls = 255 ; The maximum number of concurrent calls you want ; to allow execincludes = yes | no ; Allow #exec entries in configuration files dontwarn = yes | no ; Don't over-inform the Asterisk sysadm, he's a guru systemname = <a_string> ; System name. Used to prefix CDR uniqueid and to ; fill ${SYSTEMNAME} languageprefix = yes | no ; Should language code be last component of sound file ; name or first? ; When off, sound files are searched as ; <path>/<lang>/<file> ; When on, sound files are search as <lang>/<path>/<file> ; (only affects relative paths for sound files)