Skip to content

simplewebrtc/signalmaster

Folders and files

NameName
Last commit message
Last commit date

Latest commit

9dd8f99 · Aug 22, 2019
May 18, 2018
Oct 5, 2015
Aug 22, 2019
Jul 10, 2019
Jan 23, 2013
Mar 6, 2014
May 1, 2018
Mar 21, 2013
Apr 1, 2014
Jul 11, 2018
Jul 16, 2018
May 1, 2018
Jun 26, 2019
Jul 28, 2015
Jul 10, 2019
Jul 10, 2019

Repository files navigation

Deprecated

The open-source version of SimpleWebRTC has been deprecated. This repository will remain as-is but is no longer actively maintained. Read more about the "new" SimpleWebRTC (which is an entirely different thing) on https://simplewebrtc.com

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:

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/andyet/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.