<?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>asterisk.conf</title><link rel="stylesheet" href="styles.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /><link rel="start" href="index.html" title="Asterisk™: The Future of Telephony" /><link rel="up" href="asterisk-APP-D.html" title="Appendix D. Configuration Files" /><link rel="prev" href="I_sect1_tt2617.html" title="amd.conf" /><link rel="next" href="asterisk-APP-D-SECT-8.html" title="cdr.conf" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">asterisk.conf</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="I_sect1_tt2617.html">Prev</a> </td><th width="60%" align="center">Appendix D. Configuration Files</th><td width="20%" align="right"> <a accesskey="n" href="asterisk-APP-D-SECT-8.html">Next</a></td></tr></table><hr /></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="asterisk-APP-D-SECT-7"></a>asterisk.conf</h2></div></div></div><p><a id="I_indexterm_tt2618" class="indexterm"></a>The <span class="emphasis"><em>asterisk.conf</em></span> 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 <span class="emphasis"><em>asterisk.conf</em></span> file is generated automatically when you run the <code class="literal">make samples</code> command, based on information it collects about your system. It will contain a <code class="literal">[directories]</code> section such as the following:</p><a id="I_programlisting_tt2619"></a><pre class="programlisting">[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</pre><p>Additionally, you can specify an <code class="literal">[options]</code> 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:</p><a id="I_programlisting_tt2620"></a><pre class="programlisting">[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)</pre></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="I_sect1_tt2617.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="asterisk-APP-D.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="asterisk-APP-D-SECT-8.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">amd.conf </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> cdr.conf</td></tr></table></div><div xmlns="" id="svn-footer"><hr /><p>You are reading <em>Asterisk: The Future of Telephony</em> (2nd Edition for Asterisk 1.4), by Jim van Meggelen, Jared Smith, and Leif Madsen.<br /> This work is licensed under the <a href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-Noncommercial-No Derivative Works License v3.0</a>.<br /> To submit comments, corrections, or other contributions to the text, please visit <a href="http://oreilly.com/catalog/9780596510480/">http://www.oreilly.com/</a>.</p></div></body></html>