Skip to content

A media gateway to provide SIP access (audio+video) on top of Jitsi Meet, BBB,...web conferences

License

Notifications You must be signed in to change notification settings

Renater/SIPMediaGW

Repository files navigation

SIPMediaGW

SIPMediaGW is a Docker-based set of open-source components that allow traditional video conferencing rooms to join Jitsi or Big Blue Button web conferences using SIP and RTP protocols.

The room connector is compatible with all video devices supporting the SIP protocol. It has been tested with major devices from Polycom, Cisco, Huawei, and Aver.

SIPMediaGW relies on several open-source projects such as Coturn, Kamailio, Homer, Baresip, FFmpeg, Pulseaudio, ALSA, Video4Linux, Fluxbox.

Features

  • Audio and video support
  • Encrypted SIP and RTP traffic
  • Autoscaling logic for Cloud deployment
  • Content sharing via BFCP (Binary Floor Control Protocol)
  • Streaming capabilities via RTMP (Real-Time Messaging Protocol)

Usage

Installation

After installation, ensure that your firewall permits the following network traffic :

Firewall rules

Testing

Once the services are up and running, you can join a conference from your preferred SIP softphone. Refer to the testing section for more information.

Troubleshooting

The logs are handled by syslog of the host machine:

tail -f /var/log/syslog | grep mediagw

Inspect Kamailio database:

docker run -it --network=host --entrypoint mysql mysql -h 127.0.0.1 -u root -pdbrootpw kamailio -e "SELECT username, locked, to_stop FROM location"

For troubleshooting/monitoring purposes, real-time packet capture and visualization tools can be deployed as follows:

docker compose -f deploy/docker-compose.yml up -d --force-recreate heplify_server homer_webapp

Contributing

Contributions are always welcome.

  1. Fork the repository and create your branch from main.
  2. Open an issue to discuss proposed changes.
  3. Make your changes and ensure tests pass.
  4. Submit a pull request with a clear description of your changes.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.

About

A media gateway to provide SIP access (audio+video) on top of Jitsi Meet, BBB,...web conferences

Resources

License

Stars

Watchers

Forks

Packages

No packages published