codecs.conf.sample: update codec opus docs
[asterisk/asterisk.git] / configs / samples / asterisk.conf.sample
1 [directories](!)
2 astetcdir => /etc/asterisk
3 astmoddir => /usr/lib/asterisk/modules
4 astvarlibdir => /var/lib/asterisk
5 astdbdir => /var/lib/asterisk
6 astkeydir => /var/lib/asterisk
7 astdatadir => /var/lib/asterisk
8 astagidir => /var/lib/asterisk/agi-bin
9 astspooldir => /var/spool/asterisk
10 astrundir => /var/run/asterisk
11 astlogdir => /var/log/asterisk
12 astsbindir => /usr/sbin
13
14 [options]
15 ;verbose = 3
16 ;debug = 3
17 ;refdebug = yes                 ; Enable reference count debug logging.
18 ;alwaysfork = yes               ; Same as -F at startup.
19 ;nofork = yes                   ; Same as -f at startup.
20 ;quiet = yes                    ; Same as -q at startup.
21 ;timestamp = yes                ; Same as -T at startup.
22 ;execincludes = yes             ; Support #exec in config files.
23 ;console = yes                  ; Run as console (same as -c at startup).
24 ;highpriority = yes             ; Run realtime priority (same as -p at
25                                 ; startup).
26 ;initcrypto = yes               ; Initialize crypto keys (same as -i at
27                                 ; startup).
28 ;nocolor = yes                  ; Disable console colors.
29 ;dontwarn = yes                 ; Disable some warnings.
30 ;dumpcore = yes                 ; Dump core on crash (same as -g at startup).
31 ;languageprefix = yes           ; Use the new sound prefix path syntax.
32 ;systemname = my_system_name    ; Prefix uniqueid with a system name for
33                                 ; Global uniqueness issues.
34 ;autosystemname = yes           ; Automatically set systemname to hostname,
35                                 ; uses 'localhost' on failure, or systemname if
36                                 ; set.
37 ;mindtmfduration = 80           ; Set minimum DTMF duration in ms (default 80 ms)
38                                 ; If we get shorter DTMF messages, these will be
39                                 ; changed to the minimum duration
40 ;maxcalls = 10                  ; Maximum amount of calls allowed.
41 ;maxload = 0.9                  ; Asterisk stops accepting new calls if the
42                                 ; load average exceed this limit.
43 ;maxfiles = 1000                ; Maximum amount of openfiles.
44 ;minmemfree = 1                 ; In MBs, Asterisk stops accepting new calls if
45                                 ; the amount of free memory falls below this
46                                 ; watermark.
47 ;cache_media_frames = yes       ; Cache media frames for performance
48                                 ; Disable this option to help track down media frame
49                                 ; mismanagement when using valgrind or MALLOC_DEBUG.
50                                 ; The cache gets in the way of determining if the
51                                 ; frame is used after being freed and who freed it.
52                                 ; NOTE: This option has no effect when Asterisk is
53                                 ; compiled with the LOW_MEMORY compile time option
54                                 ; enabled because the cache code does not exist.
55                                 ; Default yes
56 ;cache_record_files = yes       ; Cache recorded sound files to another
57                                 ; directory during recording.
58 ;record_cache_dir = /tmp        ; Specify cache directory (used in conjunction
59                                 ; with cache_record_files).
60 ;transmit_silence = yes         ; Transmit silence while a channel is in a
61                                 ; waiting state, a recording only state, or
62                                 ; when DTMF is being generated.  Note that the
63                                 ; silence internally is generated in raw signed
64                                 ; linear format. This means that it must be
65                                 ; transcoded into the native format of the
66                                 ; channel before it can be sent to the device.
67                                 ; It is for this reason that this is optional,
68                                 ; as it may result in requiring a temporary
69                                 ; codec translation path for a channel that may
70                                 ; not otherwise require one.
71 ;transcode_via_sln = yes        ; Build transcode paths via SLINEAR, instead of
72                                 ; directly.
73 ;runuser = asterisk             ; The user to run as.
74 ;rungroup = asterisk            ; The group to run as.
75 ;lightbackground = yes          ; If your terminal is set for a light-colored
76                                 ; background.
77 ;forceblackbackground = yes     ; Force the background of the terminal to be
78                                 ; black, in order for terminal colors to show
79                                 ; up properly.
80 ;defaultlanguage = en           ; Default language
81 documentation_language = en_US  ; Set the language you want documentation
82                                 ; displayed in. Value is in the same format as
83                                 ; locale names.
84 ;hideconnect = yes              ; Hide messages displayed when a remote console
85                                 ; connects and disconnects.
86 ;lockconfdir = no               ; Protect the directory containing the
87                                 ; configuration files (/etc/asterisk) with a
88                                 ; lock.
89 ;stdexten = gosub               ; How to invoke the extensions.conf stdexten.
90                                 ; macro - Invoke the stdexten using a macro as
91                                 ;         done by legacy Asterisk versions.
92                                 ; gosub - Invoke the stdexten using a gosub as
93                                 ;         documented in extensions.conf.sample.
94                                 ; Default gosub.
95 ;live_dangerously = no          ; Enable the execution of 'dangerous' dialplan
96                                 ; functions from external sources (AMI,
97                                 ; etc.) These functions (such as SHELL) are
98                                 ; considered dangerous because they can allow
99                                 ; privilege escalation.
100                                 ; Default no
101 ;entityid=00:11:22:33:44:55     ; Entity ID.
102                                 ; This is in the form of a MAC address.
103                                 ; It should be universally unique.
104                                 ; It must be unique between servers communicating
105                                 ; with a protocol that uses this value.
106                                 ; This is currently is used by DUNDi and
107                                 ; Exchanging Device and Mailbox State
108                                 ; using protocols: XMPP, Corosync and PJSIP.
109 ;rtp_use_dynamic = yes          ; When set to "yes" RTP dynamic payload types
110                                 ; are assigned dynamically per RTP instance vs.
111                                 ; allowing Asterisk to globally initialize them
112                                 ; to pre-designated numbers (defaults to "yes").
113 ;rtp_pt_dynamic = 35            ; Normally the Dynamic RTP Payload Type numbers
114                                 ; are 96-127, which allow just 32 formats. The
115                                 ; starting point 35 enables the range 35-63 and
116                                 ; allows 29 additional formats. When you use
117                                 ; more than 32 formats in the dynamic range and
118                                 ; calls are not accepted by a remote
119                                 ; implementation, please report this and go
120                                 ; back to value 96.
121
122 ; Changing the following lines may compromise your security.
123 ;[files]
124 ;astctlpermissions = 0660
125 ;astctlowner = root
126 ;astctlgroup = apache
127 ;astctl = asterisk.ctl