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.