Asterisk Documentation 1.4 asterisk-conf.txt

-=NOTE: These pages are automatically updated once per
day from the Asterisk subversion repository when the repository changes revisions. Any
changes made to this page will be automatically overwritten with the
latest version from http://svn.digium.com/view/asterisk/branches/.

Asterisk Main Configuration File
-----------------------------------------------------
Below is a sample of the main Asterisk configuration file,
asterisk.conf. Note that this file is _not_ provided in
sample form, because the Makefile creates it when needed
and does not touch it when it already exists.

---------------

[directories]
; Make sure these directories have the right permissions if not
; running Asterisk as root 

; Where the configuration files (except for this one) are located
astetcdir => /etc/asterisk

; Where the Asterisk loadable modules are located
astmoddir => /usr/lib/asterisk/modules

; Where additional 'library' elements (scripts, etc.) are located
astvarlibdir => /var/lib/asterisk

; Where AGI scripts/programs are located
astagidir => /var/lib/asterisk/agi-bin

; Where spool directories are located
; Voicemail, monitor, dictation and other apps will create files here
; and outgoing call files (used with pbx_spool) must be placed here
astspooldir => /var/spool/asterisk

; Where the Asterisk process ID (pid) file should be created
astrundir => /var/run/asterisk

; Where the Asterisk log files should be created
astlogdir => /var/log/asterisk


[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)
dahdichanname = yes | no			; Should channels created by chan_dahdi be called 'DAHDI' or 'Zap';
						; defaults to 'DAHDI' if built against DAHDI, and 'Zap' if built
						; against Zaptel; also used by other applications so that they will
						; know what channel name to expect

[files]
; Changing the following lines may compromise your security
; Asterisk.ctl is the pipe that is used to connect the remote CLI
; (asterisk -r) to Asterisk. Changing these settings change the
; permissions and ownership of this file. 
; The file is created when Asterisk starts, in the "astrundir" above.

;astctlpermissions = 0660
;astctlowner = root
;astctlgroup = asterisk
;astctl = asterisk.ctl


-=NOTE: These pages are automatically updated once per
day from the Asterisk subversion repository when the repository changes revisions. Any
changes made to this page will be automatically overwritten with the
latest version from http://svn.digium.com/view/asterisk/branches/.

Asterisk Main Configuration File
-----------------------------------------------------
Below is a sample of the main Asterisk configuration file,
asterisk.conf. Note that this file is _not_ provided in
sample form, because the Makefile creates it when needed
and does not touch it when it already exists.

---------------

[directories]
; Make sure these directories have the right permissions if not
; running Asterisk as root 

; Where the configuration files (except for this one) are located
astetcdir => /etc/asterisk

; Where the Asterisk loadable modules are located
astmoddir => /usr/lib/asterisk/modules

; Where additional 'library' elements (scripts, etc.) are located
astvarlibdir => /var/lib/asterisk

; Where AGI scripts/programs are located
astagidir => /var/lib/asterisk/agi-bin

; Where spool directories are located
; Voicemail, monitor, dictation and other apps will create files here
; and outgoing call files (used with pbx_spool) must be placed here
astspooldir => /var/spool/asterisk

; Where the Asterisk process ID (pid) file should be created
astrundir => /var/run/asterisk

; Where the Asterisk log files should be created
astlogdir => /var/log/asterisk


[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)
dahdichanname = yes | no			; Should channels created by chan_dahdi be called 'DAHDI' or 'Zap';
						; defaults to 'DAHDI' if built against DAHDI, and 'Zap' if built
						; against Zaptel; also used by other applications so that they will
						; know what channel name to expect

[files]
; Changing the following lines may compromise your security
; Asterisk.ctl is the pipe that is used to connect the remote CLI
; (asterisk -r) to Asterisk. Changing these settings change the
; permissions and ownership of this file. 
; The file is created when Asterisk starts, in the "astrundir" above.

;astctlpermissions = 0660
;astctlowner = root
;astctlgroup = asterisk
;astctl = asterisk.ctl


Created by: josiahbryan, Last modification: Sat 26 of Jun, 2010 (08:36 UTC)
Please update this page with new information, just login and click on the "Edit" or "Discussion" tab. Get a free login here: Register Thanks! - Find us on Google+