This page covers licensing V-Ray for Modo with a USB Dongle.


Section Contents

Page Contents



V-Ray Licensing System

V-Ray uses a floating licensing system and it can obtain licenses from the V-Ray license server, running on any machine, which can be accessed through your network, or even over Internet. The access to the license server is done over TCP/IP protocol on port 30304. Make sure that your anti-virus or firewall software is not blocking the communication to the license server.

The V-Ray license server requires one or more dongles (hardware lock containing your licenses, similar to a USB flash drive) installed on the same machine to operate. You should receive your dongle(s) and information whether it is already reprogrammed with the necessary licenses from your reseller.

After the installation, please make sure that you have the necessary licenses as described in the V-Ray license server status section below.

Dongles are not node locked, they can be transferred without any restrictions between V-Ray license servers. This allows you to quickly set up a new license server after a computer failure or to move a dongle to different locations when necessary.

Note: If your dongle doesn't contain the necessary licenses, please go to the Dongle reprogramming page.


Starting and Stopping the V-Ray License Server

This section shows how to start and stop the V-Ray license server under the different operating systems. You need to have a machine with a V-Ray license server running and a dongle with licenses plugged in in order to run V-Ray.



If you have opted to register the V-Ray license server as a Windows service, it will start automatically on the next Windows boot and this icon will not be visible. If there is no dongle attached to the machine, it will still start as a service but you will not be able to access the web status page or use any licenses until you plug-in your dongle.

You can start a V-Ray license server from Windows Start > All Programs > Chaos Group > V-Ray License Server for x64 > Launch V-Ray license server

If Windows Firewall is enabled, you may get the message below. Select the Unblock option to allow connections to the V-Ray license server.

If the V-Ray license server starts successfully, you will get the V-Ray license server icon in the Windows System Tray:

To stop the V-Ray license service, double-click its icon in the Windows System Tray and then click Terminate V-Ray license service.


Mac OS X

If you registered the license server to run as a service during the installation, it will be registered as a start-up item by the installer. In that case, you can use the /sbin/SystemStarter command to start/stop the license server with the following commands in a Terminal window:

$ sudo /sbin/SystemStarter start vrlservice
$ sudo /sbin/SystemStarter stop vrlservice

If the license server is not registered as a service, then you can run it directly from its install location which by default is: /Applications/ChaosGroup/VRLService/snow_leopard_x86/bin.  Make sure that the dongle is plugged in. Double-click the vrlservice application in Finder to run the license server. To stop the license server, right-click on its icon and choose Quit .

The V-Ray license server can be registered to automatically run at login. To do that start it manually, then right click on its icon and from the Options menu select Open at Login.


V-Ray License Server Status

The V-Ray license server has a web interface that allows you to check its status and available licenses. The license server must be running to view the status web page. Please open the link http:// < IP_address > :30304/getstatus in a web browser, where < IP_address > is the IP address of the license server. For example:

The status page shows information about the total number of licenses available to the license server; how many of them are engaged and from which IP address they are engaged.

You have to make sure that you have V-Ray 3.0 licenses.

In the “Licenses usage summary” section you can see information about the licenses on the license server. In the Total column you can see all the available licenses on the dongle; in the Engaged column you can see how many of the licenses are currently being used, and in the Free column you can see the number of the licenses that are currently free.

The “Stored licenses details” is useful when more than one dongle is plugged in the license server. Here you can see a summary of all available licenses and the serial number of the dongle on which they are placed. If the license has an expiration date this is also displayed. In the example below, you can see that we only have one dongle connected, the serial number of the dongle is 10464580 and it has one V-Ray for SketchUp 2.0 license and one V-Ray for Rhino 2.0 license. All licenses are non-expiring.

The “Active sessions” list shows the IP addresses of all computers currently connected to the license server and the types of licenses they are using.

The “Global dongle expiration dates” shows a list of all dongles plugged in the license server and their expiration dates (different from license expiration dates explained above). In the example below there is one dongle with serial number 10552214 and it does not have an expiration date.

If you do not see V-Ray 3.0 licenses, your dongle has to be reprogrammed as described on the Dongle reprogramming page.

If you can't access the V-Ray license server web page, please refer to the “Troubleshooting” section.

Registering Dongle License as a Windows Service

The V-Ray license server can be registered as a Windows service in order to automatically run on the Windows boot. To do that go to Windows Start > All Programs > Chaos Group > V-Ray [host app] > Licensing > Administration. Right click on Register V-Ray License Service and choose Run as Administrator option.

To remove the V-Ray license server from the list of Windows services go to Windows Start > All Programs > Chaos Group > V-Ray Adv for 3ds Max... > Licensing > Administration > Remove V-Ray License Service.

Changing Dongle License Server Settings


You can change the license settings of V-Ray which specify the location of the license server. To do that run the V-Ray license client configuration utility from Windows Start > All Programs > Chaos Group > V-Ray [host app] > Licensing > Administration > Change V-Ray client license settings.

This will show you the window below, where you can specify the IP address of the machine that is running the V-Ray License Server. Please do not change the connection port that is set by default to 30304.


For example, if the license server machine has an IP address of, you have to put that address in the “License server” field, under the tab “Primary license server”.


Mac OS X

Run the  setvrlservice  program from the /Applications/ChaosGroup/V-Ray/[host app]/bin/   directory, e.g:

/Applications/ChaosGroup/V-Ray/MODO_x64/bin/ sudo setvrlservice -server= [server name or IP] -port=30304

where  [servername or IP]  is the IP address or name of the machine where the V-Ray license server is running,  without  the enclosing '[' and ']' characters (note that the entire command is just one line).

This setting is per user; if there are many users running V-Ray for Maya on the machine, you will need to set the license server location for each of them.