How to install - Debian/Ubuntu + Nginx
Requirements
- Debian 8+ or Ubuntu 16.04+ server/VPS with Nginx, PHP5/PHP7 and MySQL/MariaDB
- Access to that server via SSH as a root user
- PHP shell_exec enabled in php.ini (alternatively see Server as a systemd service below)
- telnet installed:
apt install telnet
php_mysqli
,php_curl
&php_fileinfo
extensions,php_json
extension on PHP5
Step 1
Download blabws-server-pro 32-bit or 64-bit, unzip and upload the folder blabws-server-pro under your /opt directory so that the path to the blabws-server-pro executable file is: /opt/blabws-server-pro/blabws-server-pro
.
Make sure that the file is executable: chmod +x /opt/blabws-server-pro/blabws-server-pro
or Filezilla ยป File Permissions ยป 755
Step 2
Add to the config file of Nginx inside the server block of your website:
location /MyWsServer/ {
proxy_pass http://127.0.0.1:9002;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 600s;
# connection will be closed after 600 seconds of inactivity
}
Save the file and restart Nginx: systemctl restart nginx
Step 3
Download BlaB! WS Pro (client), unzip the content in an empty folder and upload it to your server under your website root directory. CHMOD blabwspro/config.php to 666, blabwspro/attachments to 777 and navigate with your browser to YOUR-URL.COM/blabwspro/index.php and follow the instructions (3 steps only).
Step 4
At the end of the installation process you'll see a link to the Admin CP - go to Server, and set:
- Server port: remove 9002 and leave the box empty
- ProxyPass token: MyWsServer
- protocol: ws if you do not use SSL; wss if Nginx is configured with SSL
Save with OKAY, start your server from BOARD ยป SERVER STATUS, press the ESC key to display the menu, hit EXIT to go to chat.
Done!
Server as a systemd service
Alternative: without telnet and shell_exec (client 19.01 and above)
- Admin CP ยป Server ยป SystemdService click on systemd service and save the file when prompted: blabwsp.service
- Upload blabwsp.service in
/lib/systemd/system
, if no such directory:/etc/systemd/system
- Run
systemctl start blabwsp
and check if your chat is working properly - Run
systemctl enable blabwsp
to enable the service on boot