This page gives details on how to install the License Server for Chaos Group products.

Page Contents ×




The License Server is a secure way to license products online as a highly-encrypted centralized online system that manages licenses for all your systems. Additionally, the License Server also provides for users to "borrow" licenses from their online accounts and work offline without having Internet connection or a hardware dongle, for up to 14 days at a time.


Installation Process

On the Linux OS, please use your local user with the sudo command instead of the root user to run the installer.


1) Run the License Server installer that is included with the Chaos Group product installation package or download the License Server installer separately from the Downloads section of the Chaos Group website (you'll need to be logged in to access it).


2) Please read over the license agreement. To continue with the installation process, click the I Agree button.

3) You can choose to accept the default installation parameters, or use the Customize button to change these parameters.


If you are installing for the first time, then Activate during installation will be checked. If you have a previous version of the License Server installed and already activated, then this will be unchecked.

Windows Default Install path - C:\Program Files\Chaos Group\VRLService\OLS


Linux Default Install path - /usr/ChaosGroup/VRLService/OLS


macOS Default Install path - /Applications/ChaosGroup/VRLService/OLS

The format of the configuration file for the License Server has changed with version 5.0. When installing version 5.0 over already installed previous versions, the Migrate data during installation option, which is enabled by default, will transfer all of your settings made older versions of the License Server, such as enabled dongle subsystem, proxy settings, etc. Disabling this option in the Customize menu will install License Server 5.0 with all settings at their defaults and any custom settings from the previous installation will be lost.


4) The installation process will then Check for Running Applications, which may take a few minutes so please be patient.



The application may appear to be non-responsive, but it should complete its search for running applications and move on to the next step.


5) The License Server is then installed on your machine.

6) The application is registered as a service using one of the init systems available within your machine's OS. Use the appropriate service commands to start and stop the license server.


For Windows, use the Services window


For Linux, use SystemV, Upstart or systemd


For macOS, use launchctl


7) Enter your credentials, these are the same as the credentials used to log into your account at



8) The installation process is then complete.

9) If you are installing for the first time and deselected Activate during installation a browser window will open to the Chaos Group License Server interface. Click the ENABLE ONLINE LICENSING link.



If you close your browser window, an easy way to reopen the license server page is from the Manage Chaos License Server link installed with the rest of your Application shortcuts (e.g. Windows Start Menu), which will direct you to http://localhost:30304/


10)  Log in to the Chaos Group Login Portal and enter your credentials.



For more details on how the Licensing System works, please see the License Setup page.


Silent Installation

A silent installation allows you to complete V-Ray License Server installation without running the installer's GUI. To complete a silent installation, run the installer with the following command:

cgls_win_5.1.1.exe -auto

This will install the license server with the automatic preferences and accept the EULA.


If you want to specify a custom installation directory or choose not to add firewall exceptions, run the installer with the following command.

cgls_win_5.1.1.exe -gui=0 -quiet=1


The -quiet=1 argument will automatically accept the EULA. You can then select an installation directory and choose whether to include firewall exceptions.