8fa11e9526259a207dce0fa57feeba894efd0db3
[asterisk/asterisk.git] / configs / skinny.conf.sample
1 ;
2 ; Skinny Configuration for Asterisk
3 ;
4 [general]
5 bindaddr=0.0.0.0        ; Address to bind to
6 bindport=2000           ; Port to bind to, default tcp/2000
7 dateformat=M-D-Y        ; M,D,Y in any order (6 chars max)
8                         ; "A" may also be used, but it must be at the end.
9                         ; Use M for month, D for day, Y for year, A for 12-hour time.
10 keepalive=120
11
12 ;vmexten=8500           ; Systemwide voicemailmain pilot number
13                         ; It must be in the same context as the calling
14                         ; device/line
15
16 ; If regcontext is specified, Asterisk will dynamically create and destroy a
17 ; NoOp priority 1 extension for a given line which registers or unregisters with
18 ; us and have a "regexten=" configuration item.  
19 ; Multiple contexts may be specified by separating them with '&'. The 
20 ; actual extension is the 'regexten' parameter of the registering line or its
21 ; name if 'regexten' is not provided.  If more than one context is provided,
22 ; the context must be specified within regexten by appending the desired
23 ; context after '@'.  More than one regexten may be supplied if they are 
24 ; separated by '&'.  Patterns may be used in regexten.
25 ;
26 ;regcontext=skinnyregistrations
27
28 ;allow=all              ; see doc/rtp-packetization for framing options
29 ;disallow=
30
31 ; See qos.tex or Quality of Service section of asterisk.pdf for a description of these parameters.
32 ;tos=cs3                ; Sets TOS for signaling packets.
33 ;tos_audio=ef           ; Sets TOS for RTP audio packets.
34 ;tos_video=af41         ; Sets TOS for RTP video packets.
35 ;cos=3                  ; Sets 802.1p priority for signaling packets.
36 ;cos_audio=5            ; Sets 802.1p priority for RTP audio packets.
37 ;cos_video=4            ; Sets 802.1p priority for RTP video packets.
38
39 ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
40 ;jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of a
41                              ; skinny channel. Defaults to "no". An enabled jitterbuffer will
42                              ; be used only if the sending side can create and the receiving
43                              ; side can not accept jitter. The skinny channel can accept
44                              ; jitter, thus a jitterbuffer on the receive skinny side will be
45                              ; used only if it is forced and enabled.
46
47 ;jbforce = no                ; Forces the use of a jitterbuffer on the receive side of a skinny
48                              ; channel. Defaults to "no".
49
50 ;jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds.
51
52 ;jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is
53                              ; resynchronized. Useful to improve the quality of the voice, with
54                              ; big jumps in/broken timestamps, usually sent from exotic devices
55                              ; and programs. Defaults to 1000.
56
57 ;jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of a
58                              ; skinny channel. Two implementations are currently available
59                              ; - "fixed" (with size always equals to jbmaxsize)
60                              ; - "adaptive" (with variable size, actually the new jb of IAX2).
61                              ; Defaults to fixed.
62
63 ;jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no".
64 ;-----------------------------------------------------------------------------------
65
66
67 [devices]
68 ;---------------------------------- DEVICES SECTION -------------------------------
69 ; Options set under [devices] apply to all devices unless explicitly set for a particular
70 ; device. The options that can be set under devices are specified in GENERAL DEVICE OPTIONS.
71 ; These options can also be set for each individual device as well as those under SPECIFIC
72 ; DEVICE OPTIONS.
73 ;
74 ; Each label below [devices] in [] is a new device with the specific options specified below
75 ; it. Config stop reading new devices when one of the following is found: [general], [lines]
76 ; or the end of skinny.conf.
77 ;
78 ; Where options are common to both lines and devices, the results typically take that of
79 ; the least permission. ie if a no is set for either line or device, the call will not be
80 ; able to use that permission
81 ;------------------------------- GENERAL DEVICE OPTIONS ----------------------------
82 ;earlyrtp=1                  ; whether audio signalling should be provided by asterisk
83 ;                            ; (earlyrtp=1) or device generated (earlyrtp=0). default=yes
84 ;transfer=1                  ; whether the device is allowed to transfer. default=yes
85 ;------------------------------ SPECIFIC DEVICE OPTIONS ----------------------------
86 ;device="SEPxxxxxxxxxxxx     ; id of the device. Must be set.
87 ;version=P002G204            ; firmware version to be loaded. If this version is different
88 ;                            ; to the one on the device, the device will try to load this
89 ;                            ; version from the tftp server. Set to device firmware version.
90 ;-----------------------------------------------------------------------------------
91
92 ; Typical config for 12SP+
93 ;[florian]
94 ;device=SEP00D0BA847E6B
95 ;version=P002G204       ; Thanks critch
96 ;context=did
97 ;canreinvite=yes        ; Allow media to go directly between two RTP endpoints.
98 ;line=120               ; Dial(Skinny/120@florian)
99
100 ; Typical config for a 7910
101 ;[duba]                 ; Device name
102 ;device=SEP0007EB463101 ; Official identifier
103 ;version=P002F202       ; Firmware version identifier
104 ;host=192.168.1.144
105 ;permit=192.168.0/24    ; Optional, used for authentication
106 ;line=500
107
108
109 ; Typical config for a 7940 with dual 7914s
110 ;[support]
111 ;device=SEP0007EB463121
112 ;line=100
113 ;line=110
114 ;speeddial => 111,Jack Smith         ; Adds a speeddial button to a device.
115 ;speeddial => 112@hints,Bob Peterson ; When a context is specified, the speeddial watches a dialplan hint.
116 ;addon => 7914
117 ;addon => 7914
118
119 [lines]
120 ;----------------------------------- LINES SECTION --------------------------------
121 ; Options set under [lines] apply to all lines unless explicitly set for a particular
122 ; device. The options that can be set under lines are specified in GENERAL LINE OPTIONS.
123 ; These options can also be set for each individual device as well as those under SPECIFIC
124 ; LINE OPTIONS.
125 ;
126 ; Each label below [lines] in [] is a new line with the specific options specified below
127 ; it. Config stops reading new lines when one of the following is found: [general], [devices]
128 ; or the end of skinny.conf.
129 ;
130 ; Where options are common to both lines and devices, the results typically take that of
131 ; the least permission. ie if a no is set for either line or device, the call will not be
132 ; able to use that permission
133 ;-------------------------------- GENERAL LINE OPTIONS -----------------------------
134 ;earlyrtp=1                  ; whether audio signalling should be provided by asterisk
135 ;                            ; (earlyrtp=1) or device generated (earlyrtp=0). default=yes
136 ;transfer=1                  ; whether the device is allowed to transfer. default=yes
137 ;context=default             ; context to use for this line.
138 ;------------------------------- SPECIFIC LINE OPTIONS -----------------------------
139 ;setvar=                     ; allows for the setting of chanvars.
140 ;-----------------------------------------------------------------------------------
141
142 ;[100]
143 ;nat=yes
144 ;callerid="Customer Support" <810-234-1212>
145 ;mailbox=100
146 ;vmexten=8500                   ; Device level voicemailmain pilot number
147 ;regexten=100
148 ;context=inbound
149 ;linelabel="Support Line"       ; Displays next to the line 
150                                 ; button on 7940's and 7960s
151 ;[110]
152 ;callerid="John Chambers" <408-526-4000>
153 ;context=did
154 ;regexten=110
155 ;linelabel="John"
156 ;mailbox=110
157
158 ;[120]
159 ;Nothing set, so all the defaults are used
160
161 ;[500]
162 ;nat=yes
163 ;callerid="George W. Bush" <202-456-1414>
164 ;setvar=CUSTID=5678     ; Channel variable to be set for all calls from this device
165 ;setvar=ATTENDED_TRANSFER_COMPLETE_SOUND=beep   ; This channel variable will
166                                                 ; cause the given audio file to
167                                                 ; be played upon completion of
168                                                 ; an attended transfer.
169 ;mailbox=500
170 ;callwaiting=yes
171 ;transfer=yes
172 ;threewaycalling=yes
173 ;context=default
174 ;mohinterpret=default   ; This option specifies a default music on hold class to
175                         ; use when put on hold if the channel's moh class was not
176                         ; explicitly set with Set(CHANNEL(musicclass)=whatever) and
177                         ; the peer channel did not suggest a class to use.
178 ;mohsuggest=default     ; This option specifies which music on hold class to suggest to the peer channel
179                         ; when this channel places the peer on hold. It may be specified globally or on
180                         ; a per-user or per-peer basis.