0683a914931beff18e6f2f3b725a248b7d6b07bc
[sip-router] / README
1
2
3 Kamailio v4.3
4 =============
5
6 http://www.kamailio.org
7
8 Table of contents
9   I.   About Kamailio
10   II.  Feature List
11   III. Getting started
12   IV.  About the project
13   V.   Obtaining Help
14   VI.  More Information
15
16
17 I. About Kamailio
18 =================
19
20 Kamailio is an industrial-strength, free server for realtime communication,
21 based on the Session Initiation Protocol (SIP RFC3261). 
22
23 It is engineered to power Realtime Communications such as IP telephony and presence 
24 infrastructures up to large scale. With embedded support for WebSockets, HTTP,
25 MSRP and XMLrpc as well as Json-rpc it's a modern server, up to date with current
26 standards.
27
28 Kamailio keeps track of users, sets up multimedia sessions, relays instant 
29 messages and creates space for new plug-in applications. Its proven interoperability 
30 guarantees seamless integration with components from other vendors, eliminating the 
31 risk of a single-vendor trap. Kamailio has successfully participated in various 
32 interoperability tests in which it worked with the products 
33 of other leading SIP vendors.
34
35 The Kamailio software enables a flexible plug-in model for new applications: Third parties 
36 can easily link their plug-ins with the server code and provide thereby advanced and
37 customized services. With a modern RPC interface, 3rd party application can integrate
38 and interact with services provided by Kamailio. By using the EVAPI interface or the
39 embedded HTTP server restful applications can be built.
40
41 Kamailio's performance and robustness allows it to serve millions of users and accommodate needs
42 of very large operators. With a low-cost dual-CPU, the Kamailio server is able to power 
43 IP telephony services in an area as large as the Bay Area during peak hours.
44
45 The Kamailio server is extremely configurable to allow the creation of various routing and 
46 admission policies as well as setting up new and customized services. Its configurability 
47 allows it to serve many roles: network security barrier, presence server, application server, 
48 IMS server or PSTN gateway guard (Session Border Controller) for example.
49
50
51 II. Feature List
52 ================
53
54 Please visit http://www.kamailio.org/ for the most up-to-date feature list.
55 Note that as features easily are added as modules, changes can occur quickly.
56
57 Most of Kamailio's features are implemented as plug-in modules. See 
58 our web site for a current list.
59
60 III. Getting started
61 ====================
62
63 The INSTALL document will guide you through the installation.
64
65 Kamailio is composed of a core and additional modules. For each module
66 there is a README with documentation on how to configure and use the 
67 module. These are available in each modules source code directory as well
68 as on the kamailio.org web site.
69
70 We recommend that you continue with reading README-MODULES and then the
71 document named INSTALL.
72
73 IV. About kamailio.org
74 ========================
75
76 The Kamailio project has roots in a line of projects starting with SIP Express
77 Router, then OpenSER and now Kamailio. A merge project was started during the fall
78 of 2008 by developers from the OpenSER project, recently renamed to Kamailio.org
79 and SIP Express Router (SER) from iptel.org. 
80
81 Kamailio is the result of a merge of the code base and years of experience from
82 both developer teams. In release 4.0, during the spring of 2013, the
83 merger of the products was completed and a unified product was released.
84
85 See http://www.kamailio.org/ for the story of SER, OpenSER/Kamailio and kamailio.org.
86
87 V. Obtaining Help
88 =================
89
90 We offer best-effort free support for Kamailio. "best-effort" means 
91 that we try to solve your problems via email as soon as we can, 
92 subject to available manpower. 
93
94 To receive feedback to your inquiries, we recommend you to subscribe 
95 to the sr-users mailing list and post your queries there. This mailing 
96 list is set up for mutual help by the community of Kamailio users and developers. 
97 To participate in the mailing list, subscribe at the following web address: 
98          http://lists.sip-router.org/mailman/listinfo/sr-users
99
100 VI. More Information
101 ====================
102
103 Most up-to-date information is always available at our website,
104                  http://www.kamailio.org/
105
106 Particularly, it includes:
107 - administrator's guide
108 - configuration cookbooks (core, pseudovariables and transformations)
109 - module documentation
110 - installation guidelines (INSTALL)
111 - download links
112 - etc.