Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc /}}
3 {{/box}}
4
5 By default, Flexisip loads its settings from **/etc/flexisip/flexisip.conf**. If no file exists yet, you may have Flexisip to generate a fully documented one by invoking the following command:
6
7 {{code language="bash"}}
8 /opt/belledonne-communications/bin/flexisip --dump-all-default > /etc/flexisip/flexisip.conf.sample
9 {{/code}}
10
11 = File syntax =
12
13 The syntax of the file is close of INI format i.e. it is composed of sections which contain key-value parameters. A section is declared by any line on the shape of **[section-name]** and all the line following a section declaration are taken as part of the section until the next section declaration.
14
15 Each parameter are on the shape of **key=value**. The value is composed by all the characters following the** **equal symbol until the end of the line, so that any other white-space characters are taken as part of the value.
16
17 Any lines stating by a **#** character are taken as comment line.
18
19 = Main sections tour =
20
21 All the sections concern the proxy server only, except the sections listed in the table below:
22
23 (% border="1" %)
24 |=Section name|=Description
25 |[global]|The settings contains in this section are loaded by any kind of server except network settings, which concern the proxy server only.
26 |[presence-server]|Settings for the presence server only.
27 |[conference-server]|Settings for the conference server only.
28
29 All the sections which the name start by **module::** are sections concerning the configuration for each module of the proxy. Modules are features that may be independently enabled or disabled to fit your needs. By default, the proxy behaves as a simple SIP message forwarder.
30
31 Each module can be enabled or disabled by setting the **enabled** parameter in the given module section.
32
33 Usually, you may need to touch the following modules:
34
35 (% border="1" %)
36 |=Section name|=Description
37 |[module::Registrar]|Add the ability to treat REGISTERs request for several domains.
38 |(((
39 [module::Authentication]
40 )))|Performs a digest or TLS authentication. All the request are accepted if this module is off.
41 |[module::PushNotifications]|Allows to send push notifications to user agents that are not available in order to wake them up.
42 |[module::MediaRelay]|Add an RTP media relay.
43
44 = Listening interface and port =
45
46 The interfaces and port on which Flexisip listens are set by the transport parameter in the [global] section for the proxy server and in the server specific sections for the other servers.
47
48 It takes a list of SIP URIs, which the domain is used as listening local address, the port as listening port and the "transport" URI parameter as transport protocol specifier. If no transport parameter is used, then both UDP and TCP will be used.
49
50 IP address prefix are not allowed, but using a lonely wildcard character as domain will make Flexisip to listen on 0.0.0.0/0 (and [::]/0 if IPv6 is supported by the underlying OS).
51
52 Here, there are some examples:
53
54 * Enabling UDP and TCP on port 5060:
55
56 {{code}}
57 [global]
58 transports=sip:*
59 {{/code}}
60
61 * Listen on 5060 with TCP transport only:
62
63 {{code}}
64 [global]
65 transports=sip:*;transport=tcp
66 {{/code}}
67
68 * Listen on 12345 with TCP transport:
69
70 {{code}}
71 [global]
72 transports=sip:*:12345;transport=tcp
73 {{/code}}
74
75 * Use TLS as transport layer:
76
77 {{code}}
78 [global]
79 transports=sips:*
80 {{/code}}
81
82 * Use TLS for public network and TCP for local network:
83
84 {{code}}
85 [global]
86 transports=sips:1.2.3.4 sip:10.0.0.50;transport=tcp
87 {{/code}}
88
89 An FQDN may also be used as domain. Then, Flexisip will automatically find out the IP addresses on which it has to listen be doing a DNS request. This way allows you to both listen on an IPv4 and IPv6 interface by using only once transport URI ; but it is also the recommended way to tell Flexisip what is its FQDN host name.
90
91 {{code}}
92 [global]
93 transports=sip:sip.example.org;transport=tcp
94 {{/code}}
95
96 However, for some reasons, you may wish distinct the FQDN host name from the listening address. In such a case, you can use **maddr** parameter to do so.
97
98 {{code}}
99 [global]
100 transports=sip:sip.example.org;transport=tcp;maddr=1.2.3.4
101 {{/code}}
102
103 Please visit the [[Global Section Reference>>doc:Flexisip.A\. Configuration Reference Guide.master.global]] for the full documentation of **transports** parameter.
104
105 = Specific topics =
106
107 {{children/}}
108
109 = Examples of configuration =
110
111 {{documentTree root="document:public:Flexisip.HOWTOs.WebHome"/}}