Skip to content

Latest commit

 

History

History
70 lines (43 loc) · 2.56 KB

README.md

File metadata and controls

70 lines (43 loc) · 2.56 KB
Raw

signalmaster + Xirsys

Individualized credentials per client connection; requested from the Xirsys Restful API v3.

signalmaster

A simple signaling server for clients to connect and do signaling for WebRTC.

Specifically created as a default connection point for SimpleWebRTC.js

It also supports vending STUN/TURN servers with the shared secret mechanism as described in this draft. This mechanism is implemented e.g. by rfc-5766-turn-server or by a patched version of restund.

Read more:

Setup

  1. Follow the instructions below to set up and run your SignalMaster server.
  2. Apply the Xirsys API Path/Gateway and Account Info to the development.json and production.json files.
  3. Configure SignalMaster server to run over HTTPS.,

Running

Running the server requires a valid installation of node.js which can be installed from the nodejs.org website. After installing the package you will need to install the node dependencies.

  1. npm install

  2. run the server using "node server.js"

  3. In the console you will see a message which tells you where the server is running:

                     "signal master is running at: http://localhost:8888"

  4. Open a web browser to the specified URL and port to ensure that the server is running properly. You should see the message when you go to the /socket.io/ subfolder (e.g. http://localhost:8888/socket.io/), you should see a message like this:

     				{"code":0,"message":"Transport unknown"}

Production Environment

  • generate your ssl certs
$ ./scripts/generate-ssl-certs.sh
  • run in Production mode
$ NODE_ENV=production node server.js

Use with Express

var express = require('express')
var sockets = require('signalmaster/sockets')

var app = express()
var server = app.listen(port)
sockets(server, config) // config is the same that server.js uses

Docker

You can build this image by calling:

docker build -t signalmaster https://github.com/xirdev/signalmaster.git

To run the image execute this:

docker run --name signalmaster -d -p 8888:8888 signalmaster

This will start a signal master server on port 8888 exposed on port 8888.