Ari-proxy connects Asterisk, an open source communication server, to the Apache Kafka distributed streaming platform.

1. Abstract
2. Getting started
3. Metrics
4. Compatibility
5. Contributing & feedback
6. Credit & License
7. Acknowledgements

The motivation to create ari-proxy arose from the need to build distributed and resilient telephony services scaling up to millions of active users. Ari-proxy makes use of Kafka’s built-in routing concepts to ensure consistency of message streams and proper dispatching to the call-controller, the application implementing the service logic.

Please see docs/concepts.md for details on the concepts of message routing and session mapping.

In order to operate ari-proxy, make sure you have a running instance of both Asterisk and Kafka server.

ari-proxy is written in Java, so you should install and setup Java before continuing. The project is managed by maven, which requires you to install maven as well.

Build the fat jar in target/:

mvn package

ari-proxy expects the following configuration files, which should be passed to the jvm when running the fat-jar:

Run the fat jar:

java -Dconfig.file=/path/to/service.conf [-Dlog4j.configurationFile=/path/to/log4j2.xml] -jar target/ari-proxy-1.2.1-fat.jar

Ari-proxy provides service specific metrics using the micrometer framework which are available via JMX.

Note: JMX data may be exposed via HTTP using the jolokia jvm agent (see: debian/[email protected]).

We aim for compatibility with the latest stable release of

• Java OpenJDK 8
• Asterisk
• the utilized Akka Modules

To report a bug or make a request for new features, use the Issues Page in the ari-proxy Github project. We welcome any contributions. Please see the Developer Guidelines for instructions on how to submit changes.

ari-proxy is maintained by the folks at sipgate and licensed under the terms of the AGPL license.

Maintainers of this repository:

• Andreas @hekmekk
• Jonas @boettner
• Jöran @vinzens
• Moritz @m0
• Sebastian @SipSeb

Please refer to the Git commit log for a complete list of contributors.

ari-proxy is not the first of its kind. This project was inspired by the concepts underlying both go-ari-proxy by N-Visible as well as ari-proxy by CyCore Systems.