This page provides some information on how to get V-Ray Swarm up and running.


Page Contents



This guide is to serve as a reference for the installation of V-Ray Swarm.  

Installation Process

In order to use V-Ray Swarm, you need at least one additional machine with Swarm installed.

The machine from which a job is submitted from cannot be used as a V-Ray Swarm render node machine.
Type of machines
Minimum Number of Machines
V-Ray for host application* installation
V-Ray Swarm installation
Machines to start the rendering1RequiredNot required
Distributed rendering machines1Not requiredRequired

* host application refers to Revit, Sketchup, or Rhino.


To install only V-Ray Swarm on a machine intended for use in V-Ray Distributed Rendering Mode, run the V-Ray installer for your host application. Under Choose installation type, you can choose V-Ray Swarm and deselect V-Ray for your host application.

V-Ray Swarm installer will automatically remove any previous installations.


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




2) If you choose to accept the default installation parameters, click the Install Now button.


Windows Default Install path - C:\Program Files\Chaos Group\V-Ray Swarm

Mac OS X Default Install path - /Applications/ChaosGroup/V-Ray/Swarm

3) If you need to set up license and Network discovery settings, click the Customize button.


Rendering with V-Ray Swarm requires V-Ray 3.0 Render Node license. Fill in the IP address/port of the machine where V-Ray license server is running.

You can set a custom TTL value from within the V-Ray Swarm Installer. This option can also be changed after the installation by opening the swarm-config.json file located in V-Ray Swarm's work folder. Once opened, navigate to the ttl option and set a new value. Please note that swarm-config.json will not be generated unless V-Ray Swarm's settings are changed from the default ones.


4) By default, V-Ray Swarm's Network Discovery is set up to auto-discover machines on the network. If the Use auto-discovery option is disabled, the custom configuration of the manually set Master Node becomes available. This option is suitable if there is more than one subnet in the LAN or if you want to dedicate one or more machines to be Master Nodes. You may choose three machines as master nodes: one primary Master Node (Master node IP) and two alternate Master Nodes.


After you are done, click the Install Now button.


5) The installation process is now complete. Click the Finish button.





  • Swarm relies on a fast Local Area Network (LAN) to communicate between different machines. It needs this to keep open connections in order to move and distribute data.
  • Each Swarm machine needs a V-Ray 3.0 Render Node license for rendering. This means that if you have 100 computers with Swarm on them, but only 5 render node licenses, only 5 will be used to render at a time.

  • V-Ray Swarm for Windows installs Visual C++ Redistributable 2015. This dependency is needed for running V-Ray products (such as V-Ray Standalone started by the V-Ray Swarm). If the computer already has an earlier version of Visual C++ installed it will be updated to 2015. If there is a later version installed, the installer will print out an error message and use the version currently installed.