c5e7146cfda3ba6fb144a8999be0830b8fd2eecd
[asterisk/asterisk.git] / configs / sip.conf.sample
1 ;
2 ; SIP Configuration for Asterisk
3 ;
4 ; Syntax for specifying a SIP device in extensions.conf is
5 ; SIP/devicename where devicename is defined in a section below.
6 ;
7 ; You may also use 
8 ; SIP/username@domain to call any SIP user on the Internet
9 ; (Don't forget to enable DNS SRV records if you want to use this)
10
11 ; If you define a SIP proxy as a peer below, you may call
12 ; SIP/proxyhostname/user or SIP/user@proxyhostname 
13 ; where the proxyhostname is defined in a section below 
14
15 ; Useful CLI commands to check peers/users:
16 ;   sip show peers              Show all SIP peers (including friends)
17 ;   sip show users              Show all SIP users (including friends)
18 ;   sip show registry           Show status of hosts we register with
19 ;
20 ;   sip debug                   Show all SIP messages
21 ;
22
23 [general]
24 port = 5060                     ; Port to bind to
25 bindaddr = 0.0.0.0              ; Address to bind SIP channel to
26 context = default               ; Default context for incoming calls
27 ;srvlookup = yes                ; Enable DNS SRV lookups on outbound calls
28                                 ; Asterisk only uses the first host in SRV records
29 ;pedantic = yes                 ; Enable slow, pedantic checking for Pingtel
30                                 ; and multiline formatted headers for strict
31                                 ; SIP compatibility
32 ;tos=lowdelay                   ; IP QoS parameter, either keyword or value
33                                 ; like tos=184
34 ;maxexpirey=3600                ; Max length of incoming registration we allow
35 ;realm=asterisk                 ; Our global authentication realm
36 ;defaultexpirey=120             ; Default length of incoming/outoing registration
37 ;notifymimetype=text/plain      ; Allow overriding of mime type in NOTIFY
38 ;videosupport=yes               ; Turn on support for SIP video
39
40 ;disallow=all                   ; Disallow all codecs
41 ;allow=ulaw                     ; Allow codecs in order of preference
42 ;allow=ilbc
43
44 ; Asterisk can register as a SIP user agent to a SIP proxy (provider)
45 ; Format for the register statement is:
46 ;       register => user[:secret[:authuser]]@host[:port][/extension]
47 ;
48 ; If no extension is given, the 's' extension is used. The extension
49 ; needs to be defined in extensions.conf to be able to accept calls
50 ; from this SIP proxy (provider)
51 ;
52 ; host is either a host name defined in DNS or the name of a 
53 ; section defined below.
54 ;
55 ; Examples:
56 ;
57 ;register => 1234:password@mysipprovider.com    
58 ;
59 ;    Will call to the 's' extension
60 ;
61 ;
62 ;register => 2345@mysipprovider.com/1234        
63 ;
64 ;    Register 2345 at sip provider.  Calls from this provider connect to local 
65 ;    extension 1234 in extensions.conf default context, unless you define 
66 ;    [mysipprovider.com] in a section below, and configure a context
67   
68
69 ;externip = 200.201.202.203     ; Address that we're going to put in outbound SIP messages
70                                 ; if we're behind a NAT
71
72                                 ; The externip and localnet is used
73                                 ; when registering and communicating with other proxies
74                                 ; that we're registered with
75                                 ; You may add multiple local networks.  A reasonable set of defaults
76                                 ; are:
77 ;localnet=192.168.0.0/255.255.0.0; All RFC 1918 addresses are local networks
78 ;localnet=10.0.0.0/255.0.0.0    ; Also RFC1918
79 ;localnet=169.254.0.0/255.255.0.0 ;Zero conf local network
80
81 ;[snomsip]
82 ;type=friend
83 ;secret=blah
84 ;host=dynamic
85 ;dtmfmode=inband                ; Choices are inband, rfc2833, or info
86 ;defaultip=192.168.0.59
87 ;mailbox=1234,2345              ; Mailbox for message waiting indicator
88 ;restrictcid=yes                ; To have the callerid restriced -> sent as ANI
89 ;insecure=yes                   ; To match a peer based by IP address only and not peer
90 ;insecure=very                  ; To allow registered hosts to call without re-authenticating
91
92 ;[pingtel]
93 ;type=friend
94 ;username=pingtel
95 ;secret=blah
96 ;host=dynamic
97 ;qualify=1000                   ; Consider it down if it's 1 second to reply
98                                 ; Helps with NAT session
99                                 ; qualify=yes uses default value
100
101 ;callgroup=1,3-4
102 ;pickupgroup=1,3-4
103 ;defaultip=192.168.0.60
104
105 ;[cisco]
106 ;type=friend
107 ;username=cisco
108 ;secret=blah
109 ;nat=yes                        ; This phone may be natted
110                                 ; Use IP address that packet is received from
111                                 ; instead of trusting SIP headers
112 ;host=dynamic
113 ;canreinvite=no                 ; Asterisk by default tries to redirect the
114                                 ; RTP media stream (audio) to go directly from
115                                 ; the caller to the callee.  Some devices do not
116                                 ; support this (especially if one of them is 
117                                 ; behind a NAT).
118 ;qualify=200                    ; Qualify peer is no more than 200ms away
119 ;defaultip=192.168.0.4
120
121 ;[cisco1]
122 ;type=friend
123 ;username=cisco1
124 ;fromuser=markster              ; Specify user to put in "from" instead of callerid
125 ;fromdomain=yourdomain.com      ; Specify domain to put in "from" instead of callerid
126                                 ; fromuser and fromdomain are used when Asterisk
127                                 ; places calls to this account.  It is not used for
128                                 ; calls from this account.
129 ;secret=blah
130 ;host=dynamic
131 ;defaultip=192.168.0.4
132 ;amaflags=default               ; Choices are default, omit, billing, documentation
133 ;accountcode=markster           ; Users may be associated with an accountcode to ease billing