Skip to main content

Reverse Proxy Setup with Websocket Support

November 11, 2026

Article ID

5094

Product Version

AhsayCBS: 10.3 or above

Operating System

All Platforms

Description

For some AhsayCBS using proxy connection, extra configuration is required to allow websocket communication. Websocket is used to communicate with AhsayOBM/AhsayACB and also the web browser for AhsayCBS in the following areas:

  • 2FA Push Notification
  • Proxmox VE setup starting with version 10.3.0.0
  • Remote control of client run jobs starting with version 10.3.2.0

Solution

Use nginx or Apache to allow the "Upgrade" HTTP header by configuring the endpoints pnsws and cbsws.

For nginx

location /pnsws {
...
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 86400;
}
location /cbsws {
...
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 86400;
} 

For Apache

RewriteEngine On
RewriteCond %{HTTP:Upgrade} websocket [NC]
RewriteCond %{HTTP:Connection} upgrade [NC]
RewriteRule ^/(pnsws|cbsws)/(.*)$ wss://{host port to be updated}/$1/$2 [P,QSA,NC,L] 
Please make sure there are no traffic restrictions on the proxy server, which could affect backup/restore performance.