Set Up Your V-Ray License

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.

If your dongle doesn’t contain the necessary licenses, please go to the Dongle reprogramming 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.



V-Ray 3.0 requires V-Ray License server 3.0!

Installing the License Server

This section covers the installation of the V-Ray License Server. Some distributions of V-Ray install the V-Ray License Server, however we recommend that you have the latest version of the V-Ray License Server installed. To install the V-Ray License Sever please log in using your credentials and download the latest build for your operating system.

Note: The dongle must be plugged into the machine every time you need to run the V-Ray license server.

To install the V-Ray license server make sure your Windows account has administrative privileges and double-click the installation filevrlservice_3xxxx_x64.exe . Follow the instructions of the installer. Upon the start of the installation, Windows may ask you for permission to run the installer with administrator privileges. Please confirm.

  1. You will be presented with the V-Ray licensing agreement. Please take a moment to review the agreement. Click the I agree button to proceed.
  2. Next you will see the default installation settings, if no changes are needed, click Install Now. To manually configure the installation setting, click Customize.
  3. Next you can specify the installation folder for V-Ray License Server. You are also given the option to Register the V-Ray license service (check this option if you want to register the V-Ray license server as a Windows Service and automatically start upon Windows boot). In this case V-Ray license server will run in the background as a Service and there will be no need to start it up manually. There will be no V-Ray license server icon in the Windows System Tray with this method.
  4. If there is a previous version of V-Ray License Server installed, the installer will detect it and uninstall it.
  5. The installer will proceed to complete the installation. Click Finish.

Installing the Dongle Drivers

This section describes the installation of the WIBU-KEY drivers.

Some distributions of V-Ray automatically install the WIBU-KEY drivers. If you already have the WIBU-KEY drivers installed, you can skip this section. Otherwise follow these steps.

Download the appropriate drivers for your operating system from the WibuKey for Users section at the site below:

Note: Please make sure that you have the proper USB drivers installed on your machine.


  1. Make sure that the dongle is NOT plugged-in.
  2. Make sure your account has administrative privileges and run the installation file WkRuntime64.exe.
  3. Follow the instructions of the installer. You do not need to install the WIBU-KEY network server and monitor.

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 V-Ray license service double click on it’s icon in the Windows System Tray and then click Terminate V-Ray license service.


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 theFree 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 toWindows 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”.


Dongle Reprogramming

In order to reprogram your dongle you need to have the dongle plugged in, the WIBU-KEY drivers installed and the V-Ray License Server installed and running.

Important note: If your dongle serial number starts with 13 please download the latest V-Ray license server from our web site.

If you do not have the necessary V-Ray licenses on your dongle, it will have to be reprogrammed. Reprogramming a dongle is a two-part process:

  • Creating a .wbc file – you will need to create and send to Chaos Group a remote programming context file, which contains information identifying your specific dongle.
  • Updating the contents of the dongle – Chaos Group will send you file called “.rtu” file which can be used to update the licenses on your dongle.

Creating a .wbc File

Here we describe how to create a remote programing context file (“.wbc”) file, which identifies your specific dongle. If there are more dongles attached on the machine, the steps below will create one “.wbc” file containing information for all dongles. You need to have JavaScript enabled on your web browser.

  1. Please open the link http:// <IP_address> :30304/ upgrade in a web browser, where <IP_address> is the IP address of the license server. For example:


    Finding your IP address

    Please note that the IP address above is just an example for a computer which has an IP address of You need to use your particular IP address in order for the process to work. You can see how to find your IP address from the link below:

  2. A web-based wizard will appear. Click on the link shown on the screenshot:
  3. Wait until the remote context file is created.
  4. When the Success! page appears, save the remote context file by right-clicking on the link and using Save Link As…/Save Target As…
  5. Email this file to along with company and order information.

Updating the Contents of the Dongle

The support team at Chaos Group will use your “.wbc” file to generate one or more “.rtu” files and send them back to you. Each “.rtu” file is named with the serial number of the dongle that it is intended for. You can find the dongle serial number on its sticker.


  1. When you receive the “.rtu” file, save it on the machine where the dongle with the same serial number is plugged-in.
  2. If the V-Ray license server is running, stop it by double clicking its icon in the Task Bar and selecting Terminate V-Ray license service. If it is registered as a service you have to stop the V-Ray license server from Windows Control panel > Administrative tools > Services applet.
  3. Double-click the saved “.rtu” file. You will be asked to confirm the transfer on the dongle. Click Yes to update your dongle. If there is a problem, please refer to “Updating dongles when .rtu files are not associated properly” in the “Troubleshooting” section.
  4. Start the V-Ray license server from Windows Start > All Programs > Chaos Group > V-Ray License Server for x64 > Launch V-Ray license server or from the Services applet.

Leave a Reply