TOPIC: v-ray dongle

Back to Blog Posts

V-Ray Dongle and Online Licensing

If you’ve purchased V-Ray online licensing and dongle based licensing, this blog post is for you. Here we will review the details on how to use a USB dongle in conjunction with the online licensing system.

The Online Licensing system allows you to use seats associated with your Chaos Group account easily from anywhere you can log in to over the internet. If you also have a V-Ray USB License dongle attached to your workstation/server, you can utilize those available licenses within the online system.

Note that there might be some delays in detecting a dongle when it is plugged in. If, however, a dongle is not recognized at all by the system after plugging it in, try disabling and re-enabling the dongle subsystem.

Enabling Your Dongle Licenses

You can Enable your USB dongle from the Dongle drop down menu and clicking on the Enable button.


Once your USB dongle is enabled you will be able to see your dongle information.


If you need to upgrade your dongle please click the Upgrade and follow the instructions found on the following Dongle Reprogramming blog post.

Read More

V-Ray Dongle Reprogramming

This blog post covers the process for reprogramming the USB license dongle for your V-Ray products – if you’ve purchased dongle based licensing – and is broken down into the following sections:

  • Dongle Reprogramming
  • Creating a .wbc file
  • Updating the contents of the dongle
    • Windows
    • Mac OS X
    • Linux


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.

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.


Here we describe how to create a remote programming 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: 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.
  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..
    V-ray Success Screenshot
  5. Email this file to along with company and order information.


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 dongle s 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.


  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 right-clicking its icon selecting Quit. If it is registered as a service you have to stop the V-Ray license server from the Terminal with the following command: $ sudo /sbin/SystemStarter stop vrlservice
  3. In Finder, navigate to the /Applications/WIBUKEY folder and start the WkConfig application. Select the Update tab and click on the Execute Update… button to browse for the .rtu file and update the dongle.
  4. Start the V-Ray license server.


  1. When you receive the .rtu file, save it somewhere on the disk of the machine where the dongle is plugged.
  2. Close the V-Ray license server, if it is running.
  3. From a terminal window, enter the command: $ wku REMOTE USB SET FROM somefile.rtu
    where somefile.rtu is the name of the .rtu file you received from Chaos Group. Start the V-Ray license server again.

After the dongle is reprogrammed, you can check if the new licenses have been added successfully as described in V-Ray license server status at the beginning of this section. If you’ve purchased online licensing and dongle based licensing, check this blog post out.

Read More

Latest Tweets

MicrosolTweets @MicrosolTweets
Proponents of 3D printing #technology in #construction are confident not only that this trend will continue but tha…
Adopting the #Revit productivity tools you need has just become easier! Take advantage of @IdeateSoftware's Revit a…
This #architecture firm is turning an energy-draining, 1960s building in Champagne, France into a modern…
Load More...