Skip to main content

ADR Websocket Server 2025 R2

Basic operation

Last update: 17.04.2026

Websocketserver will route a TCP/IP stream from a listening socket to a client via the ws or wss protocol. Usually the client is a JavaScript application running in a browser. For example, one could tunnel the EnSight vnc protocol to a viewer in a webpage like this:

  • Launch EnSight with an embedded vnc service listening for connections on port 5900
bin\ensight.bat -vnc "vnc://?primary_password=veronica"
  • Launch websocketserver serving up some web pages (the JavaScript VNC client) on port 9000. The local host port 5900 should be served up via ws:// on port 9090
bin\cpython.bat nexus###\nexus_launcher\websocketserver.py --http_directory nexus### --http_port 9000 --client_hostname localhost --client_port 5900 --verbose 1 9090
  • In a web browser, browse to this URL
http://localhost:9000/ansys###/nexus/novnc/vnc_envision.html?password=veronica&autoconnect=true&host=localhost&port=9090

The browser-based VNC client will connect to the running EnSight instance and display the remote imagery. Websocketserver includes REST API to control its operation.

  • The server may be stopped by browsing to the URL:
http://localhost:9000/v1/stop

Connect with Ansys