Repository files navigation

Docker image with a RTPEngine

This repository contains a dockerized distribution of RTPEngine 3.x for use inFonoster. For more documentation on how Fonoster images are constructed and how to work with them, please see thedocumentation.

You can see all images available to pull from Docker Hub via theTags page. Docker tag names that begin with a "change type" word such as task, bug, or feature are available for testing and may be removed at any time.

The version is the same of the Asterisk this is image is based on

You can clone this repository and manually build it.

cd fonoster/rtpengine\:%%VERSION%%docker build -t fonoster/rtpengine:%%VERSION%% .

Otherwise you can pull this image from docker index.

docker pull fonoster/rtpengine:%%VERSION%%

The following is a basic example of using this image.

docker run -it --net=host \  -p 8080:8080 \  -e BIND_HTTP_PORT=8080 \  -e LOG_LEVEL=8 \  fonoster/rtpengine

Environment variables are used in the entry point script to render configuration templates. You can specify the values of these variables duringdocker run,docker-compose up, or in Kubernetes manifests in theenv array.

• PUBLIC_IP - Host's external IP. If undefined, the container will attempt to guess the host's public IP
• BIND_HTTP_PORT - The port the container is listening on for HTTP requests. Defaults to8080
• BIND_NG_PORT - The port the container is listening on for NG requests. Defaults to22222
• LOG_LEVEL - Level of verbosity of the logs. Defaults to7
• PORT_MIN - Lower value of port range. Defaults to10000
• PORT_MAX - Upper value of port range. Defalts to10500
• CLOUD - Name of cloud the provided. This will help the container determine its public IP. Acceptable values are:gcp,aws,digitalocean,azure, and*. Defaults to*
• HOMER_ADDR - Host and port of the HOMER server. If defined, the container will send RTP statistics to the specified HOMER server. Defaults tonil
• HOMER_PROTOCOL - Protocol used to send RTP statistics to the HOMER server. Acceptable values are:udp andtcp. Defaults toudp
• HOMER_ID - ID of the HOMER server. Defaults to random four digit number.

• 8080 - Default HTTP port
• 22222 - Default NG port

This container requires of "host" mode to do its job. The ports PORT_MIN to PORT_MAX must be open on the host.

Please readCONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

• Pedro Sanders

See also the list of contributors whoparticipated in this project.

Copyright (C) 2024 by Fonoster Inc. MIT License (seeLICENSE for details).