misc/examples/kemi: engine python for app_python3s
[kamailio] / README.md
1 # Kamailio - The Open Source SIP Server
2
3 [![Build Status](https://github.com/kamailio/kamailio/actions/workflows/main.yml/badge.svg)](https://github.com/kamailio/kamailio/actions)
4 [![Code Triage Badge](https://www.codetriage.com/kamailio/kamailio/badges/users.svg)](https://www.codetriage.com/kamailio/kamailio)
5
6 Project Website:
7
8   * https://www.kamailio.org
9
10 [20 Years Of Kamailio Development: Sep 3, 2001 - Sep 3, 2021](https://www.kamailio.org/w/2021/09/kamailio-20-years-of-development/)
11
12 ## Overview
13
14 Kamailio is an open source implementation of a SIP Signaling Server. SIP is an open standard protocol specified by the IETF. The core specification document is [RFC3261](https://tools.ietf.org/html/rfc3261).
15
16 The Kamailio SIP server is designed for scalability, targeting large deployments (e.g. for IP telephony operators or carriers, which have a large subscriber base or route a big volume of calls), but can be also used in enterprises or for personal needs to provide VoIP, Instant Messaging and Presence. Kamailio is well known for its flexibility, robustness, strong security and the extensive number of features - for more information, please see:
17
18   * https://www.kamailio.org/w/features/
19
20 Kamailio development was started back in 2001 by [Fraunhofer Fokus](https://www.fokus.fraunhofer.de/), a research institute in Berlin, Germany. At that time the project name was SIP Express Router (aka SER). In 2005, a fork named OpenSER was created, which was renamed to Kamailio in July 2008 due to trademark issues. Starting in the autumn of 2008, Kamailio and SER initiated the process to merge the two projects. After the merge was complete, Kamailio became the main name of the project, being better protected in terms of trademarks.
21
22 Fraunhofer Fokus is no longer actively involved in the evolution of the project. Kamailio is  now developed and managed by its world wide community. Fokus still uses Kamailio in its research projects (such as OpenIMSCore) and it is hosting events related to the project, such as developer meetings or the Kamailio World Conference.
23
24 For more information about Kamailio, see the [website of the project](https://www.kamailio.org), where you can find pointers to documentation, the project wiki and much more.
25
26 ## Contributions
27
28 Github pull requests are the recommended way to contribute to Kamailio source code or documentation:
29
30   * https://github.com/kamailio/kamailio/pulls
31
32 To keep a coherent and consistent history of the development, the commit messages format and content must follow the rules detailed at:
33
34   * https://www.kamailio.org/wiki/devel/github-contributions
35
36 Contributions must conform with licensing rules of the Kamailio project.
37
38 ## License
39
40 Main License: GPLv2.
41
42 Each source code file refers to the license and copyright details in the top of the file. Most of the code is licensed under GPLv2, some parts of the code are licensed under BSD.
43
44 ### License Of New Code Contributions
45
46 New contributions to the core and several main modules (auth, corex, sl, tls, tm) have to be done under the BSD license. New contributions under the GPL must grant the GPL-OpenSSL linking exception. Contributions to existing components released under BSD must be done under BSD as well.
47
48 ## Documentation
49
50 The main index for documentation is available at:
51
52   * https://www.kamailio.org/w/documentation/
53
54 The online documentation for modules in the latest stable branch:
55
56   * https://kamailio.org/docs/modules/stable/
57
58 The wiki collects a consistent number of tutorials, the indexes for variables, functions and parameters:
59
60   * https://www.kamailio.org/wikidocs/
61
62 Please read the README file in the source code, one per module.
63
64 ### Installation
65
66 Step by step tutorials to install Kamailio from source code are available at:
67
68   * https://www.kamailio.org/wikidocs/#installation
69
70 Please read the INSTALL file from the source code for more information.
71
72 Repositories for Linux packages:
73
74   * deb: https://www.kamailio.org/wikidocs/packages/debs
75   * rpm: https://www.kamailio.org/wikidocs/packages/rpms
76
77 ## Issues And Bug Reports
78
79 To report a bug or make a request for new features, use the Issues Page in the Kamailio Github project:
80
81   * https://github.com/kamailio/kamailio/issues
82
83 ## Open Support And Community Discussions
84
85 ### Mailing Lists
86
87 Mailing list for discussions regarding stable versions of Kamailio:
88
89   * **sr-users (at) lists.kamailio.org** - [sr-users web page](https://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-users)
90
91 Mailing list for discussions regarding the development of Kamailio and the state of master (devel) branch:
92
93   * **sr-dev (at) lists.kamailio.org** - [sr-dev web page](https://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-dev)
94
95 Mailing list for discussions with commercial purpose:
96
97   * **business (at) lists.kamailio.org** - [business web page](https://lists.kamailio.org/cgi-bin/mailman/listinfo/business)
98
99 For more information about the mailing lists, please see:
100
101   * https://www.kamailio.org/w/mailing-lists/
102
103 ### IRC Channel
104
105 An open IRC discussion channel is managed by the community:
106
107   * irc server: irc.freenode.net
108   * irc channel: #kamailio
109
110 ### Matrix Channel
111
112 An open Matrix discussion channel is managed by the community:
113
114   * server: https://riot.kamailio.dev/
115   * Room: https://riot.kamailio.dev/#/room/#kamailio:matrix.kamailio.dev
116
117 ## Useful Resources
118
119 News:
120
121   * https://www.kamailio.org/w/category/news/
122   * Twitter @kamailio
123
124 ## Travis-CI - Testing Build Environment
125
126  * [travis-ci](https://travis-ci.org/kamailio/kamailio/builds/)
127  * [docker build](/test/travis/README.md)
128
129 **Thank you for flying Kamailio!**