Installation Guide

Requirements

  1. Any modern 64 bit CPU
  2. 20 GB of disk space
  3. 4 GB RAM
  4. An installation of 64 bit Debian (any of Jessie, Stretch or Buster).

Adding Repository

Please read the section Adding Repository in the SIPIS installation guide.

Installing Webis

Run:

apt-get install webis

This will install Webis. Now you need to configure it and set up reverse proxy in front of it.

Configuring Webis

Webis configuration is stored in /etc/acrobits/webis/settings/common.xml. Most of the values have reasonable defaults. You should replace X.X.X.X with the IP address of your Webis server in WebisCommon/RtpProxy/Addresses/Address node.

Setting up reverse proxy

Webis needs to be behind a HTTPS proxy that provides TLS encryption. We recommend you use nginx for this. See the following sample configuration file and adjust it to your needs:

server {
  listen 443 ssl;

  ssl_certificate /path/to/cert.pem;
  ssl_certificate_key /path/to/key.pem;


  server_name webis.example.com;

  location / {
     proxy_pass http://webis;
     proxy_http_version 1.1;

     proxy_connect_timeout 7d;
     proxy_send_timeout 7d;
     proxy_read_timeout 7d;

     proxy_set_header Upgrade $http_upgrade;
     proxy_set_header Connection "upgrade";
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     proxy_set_header Host $host;

  }
}
upstream webis {
  server 127.0.0.1:4210;
}

Running Webis

Start webis by running

systemctl start webis.service

To have webis start automatically on computer start, run

systemctl enable webis.service

Upgrading Webis

You can upgrade Webis in the same way as you upgrade any other package. First run

apt-get update

And then either

apt-get upgrade

to upgrade all packages or

apt-get install --only-upgrade webis

to upgrade just webis.

Firewall configuration

Your Webis installation should be reachable from your customer’s devices on the following ports:

  • 443/tcp (WebSocket connection)
  • all/udp (RTP/RTCP packets)

Your Webis should be able to connect to your SIP server on the port you use (typically 5060 or 5061 for TLS). Then it needs to be able to connect to providers.cloudsoftphone.com (to port 443).

Also, if you are using any RTP proxies, Webis should be able to reach them over all UDP ports. Without RTP proxies, Webis should be able to reach the whole outside world over all UDP ports.