(LEGACY) Websockets Connector for Yjs (Server)

Note: this is an outdated repository which is not compatible with y-websocket or Yjs>=v13

y-websockets-server is the connection point for y-websockets-client. It saves the shared data (using the memory or the leveldb database adapter), and distributes it efficiently to all connected clients.

Instructions for y-leveldb

The memory database adapter is installed by default. If you intend to use the y-leveldb database adapter, make sure to install it first.

npm install --save y-leveldb [-g]

Global installation (easy)

Install package npm install -g y-websockets-server
Execute binary y-websockets-server [--port port] [--db db] (defaults: port = 1234, db = memory (choose either leveldb or memory)).

Yjs uses debug for logging. In order to turn on logging set the environment variable DEBUG to y*,-y:connector-message: I.e

DEBUG=y*,-y:connector-message y-websockets-server --port 1234

This is how you redirect the output to a file:

DEBUG_COLORS=0 DEBUG=y*,-y:connector-message y-websockets-server --port 1234 > log.txt

Local installation (recommended if you intend to modify y-websockets-server)

Set up a new project

  mkdir my-y-websockets-server && cd $_ && git init && npm init && echo "node_modules" > .gitignore

Install npm i --save y-websockets-server
Copy executable cp node_modules/y-websockets-server/src/server.js .
Start server node server.js

Setup with Docker

Clone this repository and navigate to it.
Build the image: docker build -t y-websockets-server .
Run it: docker run -it --rm -p 1234:1234 --name y-websockets-server y-websockets-server
Feel free to modify the port argument, e.g. to -p 1773:1234 to run it at port 1773.

Setup with Heroku

Heroku is really easy to set up, and you get a free y-websockets-server with https! Preliminarily you have to set up heroku - see this great getting started guide

Perform the steps from the local installation
Create Procfile echo "web: DEBUG=y*,-y:connector-message server.js" > Procfile
Specify a node environment. Add this to your package.json:
```
  "engines": {
    "node": "6.9.1"
  }
```
Add heroku app heroku create my-websockets-server
Commit & Push to heroku git add -A && git commit -am 'init' && git push heroku master
Start app heroku ps:scale web=1
Get the url for your websockes-server instance heroku info (see Web Url).