Skip to content

palavatv/signaltower

Repository files navigation

palava | signal tower

Elixir CI

palava.tv is a cost-free, simple to use, secure, and open source platform for video calls, built on top of the WebRTC technology.

This repository contains the WebRTC signaling backend of palava.tv. There is an overview of all parts of palava.tv at palavatv/palava.

The signal tower is a signaling server for WebRTC applications written in Elixir. It implements the palava signaling protocol over websockets to be used together with the palava client.

Setup

Install:

mix deps.get
mix deps.compile

Test:

mix test

You can also watch file changes and rerun tests automatically:

mix test.watch

Start locally:

./start.sh or ./start_daemon.sh

Release and use in production:

mix release production

Options:

To use a Turn Server, generate a secret key string, e.g. via openssl rand -base64 30 and set:

export SIGNALTOWER_TURN_SECRET=<generated_secret_key>

The same secret key must be configured in the turn server. For example for coturn, use the following configuration in turnserver.conf:

use-auth-secret
static-auth-secret=<generated_secret_key>

By default, the websocket port 4233 is used, you can change it via:

export SIGNALTOWER_PORT=1234

By default, the websocket is bound to all interfaces (0.0.0.0), you can also bind it just localhost (127.0.0.1) via:

export SIGNALTOWER_LOCALHOST

References