To enable customization, remove the _ underscore from the sample configuration file names ViewStationWeb.ini_ and CRendererInstance.ini_.

Set your ClientPort and LogPath in ViewStationWeb.ini

Set your ModelRepository root path and LogPath in CRendererInstance.ini

There is a sample CRendererInstance.ini_ showing how to modify all paths

Edit your server address by modifying this variable g_sWebSocketAdress (remove the comment at the beginning of the line //) in ..\WebViewer\www\custom\overrides.js (or optionally in ..\WebViewer\www\index.html or other sample code files), see same examples below.

All lines starting with ; in configuration files are comment lines and are not read by the WebViewer. Please make sure that all lines you change do not start with ;.

After setting the ModelRepository variable, the server only allows files to be loaded from the defined repository or subdirectories by passing a relative file path.

By default, the sample model folder (subfolder of the WebViewer base directory) is set, which contains a number of demo models. If you want to change the model folder, you have to change the path: ModelRepository=C:\WebViewer\models

The main service ViewStationWeb.exe starts a websocket server and a simple HTTP server on a specified port.

Without ViewStationWeb.ini, the WebViewer runs on port 80, using localhost as the host name for the client connection.

For security reasons, SSL off-loading and WSS (Web socket secure), we recommend running a proxy in front of the WebViewer server in production environments. In this case you have to overwrite g_sWebSocketAdress with the proxy routed address (e.g. g_sWebSocketAdress = "wss://vsweb.kisters.de/ws").

For more information and a sample configuration for NGINX or Apache HTTP Server as a reverse proxy, see ..\WebViewer\ssl\.

It is possible to customize the ribbon interface. There are some sample files in the ..\WebViewer\www\custom folder.

The userdefined.js provides a template for defining a new ribbon group with the corresponding buttons. The ribbon.js defines the visibility of ribbon groups and panes. It is possible to hide an entire ribbon group or individual buttons. If all ribbon groups are set to false, the ribbon disappears completely.