Websocket installation

Install the jitsi websocket

After version 0.75.x we change from mercure HUB, who was a SSE service to a real node websocket. With this service we have a lot of more opportunities and can go in a modern future with the jitsi-admin. To install the jwebsocket on your system follow these steps on an ubuntu or debian.

IMPORTANT: The WEBSOCKET_SECRET parameter in the service must match the MERCURE_JWT_SECRET parameter in the jitsi-admin .env.local file.

Install Node 16

       sudo apt update
       sudo apt upgrade
       sudo apt install -y curl
       curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
       sudo apt install -y nodejs
       node --version
       v16.1.0

Copy node files into bin directory

make sure you have a Version with a websocket. This is >0.75.0

mkdir /opt/jitsi-admin-websocket
cp -r nodejs/ /opt/jitsi-admin-websocket/
cd /opt/jitsi-admin-websocket
npm install

Create systemd file to run node as a service

#/etc/systemd/system/jitsi-admin-websocket.service
[Unit]
     Description=Jitsi-Admin Websocket Service
     After=network.target
     StartLimitBurst=5
     StartLimitIntervalSec=33


     [Service]
     Type=simple
     WorkingDirectory=/opt/jitsi-admin-websocket/nodejs
    
     Environment= WEBSOCKET_SECRET='MY_SECRET'
#change MY_SECRET to the Secret you set in the jitsi-admin.env
     ExecStart=node .
     StandardOutput=file:/var/log/jitsi-websocket/access.log
     StandardError=file:/var/log/jitsi-websocket/error.log
     Restart=always
     RestartSec=5

     [Install]
     WantedBy=multi-user.target

Enable the Websocket Service

mkdir mkdir /var/log/jitsi-websocket/
systemctl daemon-reload
systemctl enable jitsi-admin-websocket.service
systemctl start jitsi-admin-websocket.service
systemctl restart jitsi-admin-websocket.service

Set the websocket in the .env.local file of the jitsi-admin directory

MERCURE_URL=http://localhost:3000/.well-known/mercure
MERCURE_PUBLIC_URL=<yourdomain>
MERCURE_JWT_SECRET=MY_SECRET #Set here the Secret as in the systemd file