Changing the Product License Setup

This page provides information on configuring the product to use the Chaos Licensing service directly or a license server.

Overview

Chaos products can use two licensing models: Cloud Licensing and the License Server.

Cloud Licensing offers maximum flexibility, allowing users to sign in with their Chaos account and use the product from any location with an Internet connection. The License Server is useful for deploying a centralized setup, but requires users to have access to the same local network as the License Server.

The product can be configured to use either licensing mode during installation, and this can be changed at any time with the Change License Settings utility that gets installed alongside the product. The utility can also be used to point the product to the correct IP address of the License Server.

Licensing Mode

• Cloud Licensing (recommended) – Configures all Cloud-enabled Chaos products on the device to connect directly to Chaos Licensing without a License Server. Note that the License Server settings are still used by Chaos product versions that do not support Cloud licensing. Cloud-enabled versions will use Cloud Licensing, while older, non-Cloud-enabled versions will use the License Server Configuration.
• License Server – Configures all Chaos products on the device to connect to a License Server located at the IP address in the Configuration section.

License Server Configuration

• License Server – The IP address of the Chaos License Server in the local network. To configure the product to connect to a License Server that runs on the same device as the product, enter 127.0.0.1 or localhost. To connect to a remote License Server in the same local network, enter the IP address of the machine that runs the License Server.

• Override Port (Default 30304) – This option can be used to override the default port in case this port is used by another application or when multiple instances of the Chaos License Server run on the same device.
• Show Alternative Servers – This set of options allows configuring the product to connect to one of several instances of the Chaos License Server in the same local network. Redundancy setups for network deployments usually have more than one Chaos License Server. When alternate servers are configured, the product will attempt to connect to one IP address after another to engage a license.

Starting the Change License Settings utility

Windows

macOS

Linux

The Change Chaos License Settings utility can be started from Windows Start > Search for Change license settings.

It can also be started manually and the location depends on the Chaos product you have installed.

The executable file of the utility is called setvrlservice. Here are some examples of the default location:

• Enscape – C:\Program Files\Enscape\tools
• V-Ray for 3ds Max – C:\ProgramData\Autodesk\ApplicationPlugins\VRay3dsMax2025\utils
• V-Ray for SketchUp – C:\Program Files\Chaos\V-Ray\V-Ray for SketchUp\extension\vray\bin\
• V-Ray for Rhino – C:\Program Files\Chaos\V-Ray\V-Ray for Rhinoceros\vrayappsdk\bin\
• Envision – C:\Program Files\Chaos\Envision\bin
• Vantage – C:\Program Files\Chaos\Vantage
• Anima – C:\Program Files\Chaos\Anima
• Corona – C:\Program Files\Chaos\Corona\tools

The location of the Change Chaos License Settings utility depends on the Chaos product you have installed.

The executable file of the utility is called setvrlservice. Here are some examples of the default location:

• Enscape – /Library/Chaos/Enscape/tools/
• V-Ray for SketchUp – /Applications/Chaos/V-Ray/V-Ray for SketchUp/extensions/vray/bin/
• V-Ray for Maya – /Applications/Chaos/V-Ray/Maya2026/maya_vray/bin/

The location of the Change Chaos License Settings utility depends on the Chaos product you have installed.

The executable file of the utility is called setvrlservice. Here are some examples of the default location:

• V-Ray for Maya – /usr/Chaos/V-Ray/Maya2026/maya_vray/bin/
• V-Ray for Houdini – /usr/Chaos/V-Ray/Houdini_20.5/appsdk/bin/

Command-Line Interface

You can run setvrlservice in a command prompt or terminal.

The -cloud-server flag changes the Licensing Mode, e.g. setvrlservice -cloud-server.

When the -cloud-server flag is used without a value, it enables Cloud Licensing. To disable Cloud Licensing and switch to using a License Server, use the flag with a value of zero.

The -server flag changes the IP address of the License Server that Chaos products connect to, e.g. -server=<server name or IP>. A value of localhost or 127.0.0.1 connects Chaos products to a locally running License Server on the same device. Any other value connects Chaos products to a remotely running License Server on another machine in the same local network.

Use the -help flag to read the full help message for more details.

Notes

The license configuration is stored in a file called vrlclient.xml placed by default under C:\Program Files\Common Files\ChaosGroup on Windows, /home/<user>/.ChaosGroup on Linux, and /Users/<user>/.ChaosGroup/ on macOS.

The Change License Settings utility, as well as the Chaos product installer, reads and writes to the same file. As an alternative, the xml file can be directly edited in a text editor. Editing the file requires Administrative privileges.