Statistics
| Branch: | Revision:

janus-gateway / conf / janus.cfg.sample.in @ f82a8605

History | View | Annotate | Download (6.83 KB)

1 be35facb meetecho
; General configuration: folders where the configuration and the plugins
2 f82a8605 Lorenzo Miniero
; can be found, how output should be logged, whether Janus should run as
3
; a daemon or in foreground, default interface to use, debug/logging level
4
; and, if needed, shared apisecret and/or token authentication mechanism
5
; between application(s) and Janus.
6 be35facb meetecho
[general]
7 f4fb2029 Jack Leigh
configs_folder = @confdir@		; Configuration files folder
8
plugins_folder = @plugindir@		; Plugins folder
9 f82a8605 Lorenzo Miniero
;log_to_stdout = false			; Whether the Janus output should be written
10
								; to stdout or not (default=true)
11
;log_to_file = /tmp/janus.log	; Whether to use a log file or not
12
;daemonize = true				; Whether Janus should run as a daemon
13
								; or not (default=run in foreground)
14 5e9e29e0 meetecho
;interface = 1.2.3.4		; Interface to use (will be used in SDP)
15 3a26e009 meetecho
debug_level = 4				; Debug/logging level, valid values are 0-7
16 64a3eff7 Lorenzo Miniero
;debug_timestamps = yes		; Whether to show a timestamp for each log line
17
;debug_colors = no			; Whether colors should be disabled in the log
18 be568a2e Saúl Ibarra Corretgé
;api_secret = janusrocks		; String that all Janus requests must contain
19 aff9f5c0 meetecho
;							to be accepted/authorized by the Janus core.
20
;							Useful if you're wrapping all Janus API requests
21
;							in your servers (that is, not in the browser,
22
;							where you do the things your way) and you
23
;							don't want other application to mess with
24
;							this Janus instance.
25 263ce349 Lorenzo Miniero
;token_auth = yes			; Enable a token based authentication
26
;							mechanism to force users to always provide
27
;							a valid token in all requests. Useful if
28
;							you want to authenticate requests from web
29
;							users. For this to work, the Admin API MUST
30
;							be enabled, as tokens are added and removed
31
;							through messages sent there.
32 f7fca695 meetecho
admin_secret = janusoverlord	; String that all Janus requests must contain
33
;								  to be accepted/authorized by the admin/monitor.
34 435b1546 Lorenzo Miniero
;								  only needed if you enabled the admin API
35
;								  in any of the available transports.
36 f7fca695 meetecho
37
38 435b1546 Lorenzo Miniero
; Certificate and key to use for DTLS.
39 be35facb meetecho
[certificates]
40 02460f0e Jack Leigh
cert_pem = @certdir@/mycert.pem
41
cert_key = @certdir@/mycert.key
42 be35facb meetecho
43 f7fca695 meetecho
44 5fa9a305 meetecho
; Media-related stuff: right now, you can only configure whether you want
45 47dacad9 meetecho
; to enable IPv6 support (still WIP, so handle with care), the maximum size
46 cb50c46d meetecho
; of the NACK queue for retransmissions per handle the range of ports to
47
; use for RTP and RTCP (by default, no range is envisaged) and the
48
; starting MTU for DTLS (1472 by default, it adapts automatically).
49 263ce349 Lorenzo Miniero
[media]
50 5fa9a305 meetecho
;ipv6 = true
51 47dacad9 meetecho
;max_nack_queue = 300
52 5e9e29e0 meetecho
;rtp_port_range = 20000-40000
53 cb50c46d meetecho
;dtls_mtu = 1200
54 5e9e29e0 meetecho
55 f7fca695 meetecho
56 3b6c55f3 Lorenzo Miniero
; NAT-related stuff: specifically, you can configure the STUN/TURN
57
; servers to use to gather candidates if the gateway is behind a NAT,
58
; and srflx/relay candidates are needed. In case STUN is not enough and
59 b3060180 meetecho
; this is needed (it shouldn't), you can also configure Janus to use a
60
; TURN server; please notice that this does NOT refer to TURN usage in
61
; browsers, but in the gathering of relay candidates by Janus itself,
62
; e.g., if you want to limit the ports used by a Janus instance on a
63 b4359229 meetecho
; private machine. Furthermore, you can choose whether Janus should be
64
; configured to work in ICE-Lite mode (by default it doesn't). Finally,
65
; you can also enable ICE-TCP support (beware that it currently *only*
66 3b6c55f3 Lorenzo Miniero
; works if you enable ICE Lite as well), choose which interfaces should
67
; be used for gathering candidates, and enable or disable the
68 b4359229 meetecho
; internal libnice debugging, if needed. 
69 ddc1f702 meetecho
[nat]
70 be35facb meetecho
;stun_server = stun.voip.eutelia.it
71
;stun_port = 3478
72 4ff5ba49 meetecho
nice_debug = false
73 b4359229 meetecho
;ice_lite = true
74 b3060180 meetecho
;ice_tcp = true
75 51e16f21 meetecho
76 4b131434 Lorenzo Miniero
; In case you're deploying Janus on a server which is configured with
77
; a 1:1 NAT (e.g., Amazon EC2), you might want to also specify the public
78
; address of the machine using the setting below. This will result in
79
; all host candidates (which normally have a private IP address) to
80
; be rewritten with the public address provided in the settings. As
81
; such, use the option with caution and only if you know what you're doing.
82
;nat_1_1_mapping = 1.2.3.4
83
84 51e16f21 meetecho
; You can configure a TURN server in two different ways: specifying a
85
; statically configured TURN server, and thus provide the address of the
86
; TURN server, the transport (udp/tcp/tls) to use, and a set of valid
87
; credentials to authenticate...
88 b3060180 meetecho
;turn_server = myturnserver.com
89
;turn_port = 3478
90 ca86a513 meetecho
;turn_type = udp
91 b3060180 meetecho
;turn_user = myuser
92
;turn_pwd = mypassword
93 ddc1f702 meetecho
94 51e16f21 meetecho
; ... or you can make use of the TURN REST API to get info on one or more
95
; TURN services dynamically. This makes use of the proposed standard of
96
; such an API (https://tools.ietf.org/html/draft-uberti-behave-turn-rest-00)
97
; which is currently available in both rfc5766-turn-server and coturn.
98
; You enable this by specifying the address of your TURN REST API backend
99
; and, if required, the API key Janus must provide.
100
;turn_rest_api = http://yourbackend.com/path/to/api
101
;turn_rest_api_key = anyapikeyyoumayhaveset
102
103 3b6c55f3 Lorenzo Miniero
; You can also choose which interfaces should be explicitly used by the
104
; gateway for the purpose of ICE candidates gathering, thus excluding
105
; others that may be available. To do so, use the 'ice_enforce_list'
106 a84d557a Lorenzo Miniero
; setting and pass it a comma-separated list of interfaces or IP addresses
107
; to enforce. This is especially useful if the server hosting the gateway
108
; has several interfaces, and you only want a subset to be used. Any of
109
; the following examples are valid:
110 3b6c55f3 Lorenzo Miniero
;     ice_enforce_list = eth0
111
;     ice_enforce_list = eth0,eth1
112 a84d557a Lorenzo Miniero
;     ice_enforce_list = eth0,192.168.
113
;     ice_enforce_list = eth0,192.168.0.1
114 3b6c55f3 Lorenzo Miniero
; By default, no interface is enforced, meaning Janus will try to use them all.
115
;ice_enforce_list = eth0
116
117
; In case you don't want to specify specific interfaces to use, but would
118
; rather tell Janus to use all the available interfaces except some that
119
; you don't want to involve, you can also choose which interfaces or IP
120
; addresses should be excluded and ignored by the gateway for the purpose
121
; of ICE candidates gathering. To do so, use the 'ice_ignore_list' setting
122
; and pass it a comma-separated list of interfaces or IP addresses to
123
; ignore. This is especially useful if the server hosting the gateway
124
; has several interfaces you already know will not be used or will simply
125
; always slow down ICE (e.g., virtual interfaces created by VMware).
126
; Partial strings are supported, which means that any of the following
127
; examples are valid:
128 ddc1f702 meetecho
;     ice_ignore_list = vmnet8,192.168.0.1,10.0.0.1
129
;     ice_ignore_list = vmnet,192.168.
130 3b6c55f3 Lorenzo Miniero
; Just beware that the ICE ignore list is not used if an enforce list
131
; has been configured. By default, Janus ignores all interfaces whose
132
; name starts with 'vmnet', to skip VMware interfaces:
133 ddc1f702 meetecho
ice_ignore_list = vmnet
134 57953fa0 meetecho
135
; Finally, you can choose which of the available plugins should be
136
; enabled or not. Use the 'disable' directive to prevent Janus from
137 a77365eb meetecho
; loading one or more plugins: use a comma separated list of plugin file
138 57953fa0 meetecho
; names to identify the plugins to disable. By default all available
139
; plugins are enabled and loaded at startup. 
140
[plugins]
141
; disable = libjanus_voicemail.so,libjanus_recordplay.so