Table of Contents

To run V-Ray, you have to:


V-Ray installer automatically uninstalls any previous versions. Uninstalling V-Ray from Revit does not uninstall Chaos Cloud Client, Chaos Cosmos Browser, Chaos License Server, Chaos Unified Login and V-Ray Swarm. Those can be uninstalled separately if needed.

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

A complete installation of V-Ray for Revit consists of:

  • V-Ray
  • V-Ray License Server
  • V-Ray Swarm
  • Chaos Cloud Client app
  • Chaos Cosmos Browser service
  • Chaos Unified Login

Download V-Rat for Revit

Installing V-Ray for Revit gives you access to:

To start the installation, double-click the installation file. The V-Ray installer automatically removes any previous installations. This allows seamless upgrade from previous versions. If you experience problems, manually uninstall the previous versions to perform a clean install. See the Uninstall V-Ray page for more information.

Revit VersionInstaller Name
Revit 2025 x64vray_adv_61005_revit_win_x64
Revit 2024 x64vray_adv_61005_revit_win_x64
Revit 2023 x64vray_adv_61005_revit_win_x64
Revit 2022 x64vray_adv_61005_revit_win_x64
Revit 2021 x64vray_adv_61005_revit_win_x64
Revit 2020 x64vray_adv_61005_revit_win_x64
Revit 2019 x64vray_adv_61005_revit_win_x64

Running the Installer

End User License Agreement

Once you've carefully read the License Agreement, click I Agree if you agree to the terms.

Host App Version

This screen allows you to select which Revit version to install V-Ray for. You can also select more than one version at once.

Proceed to click the Install button.

If you need to customize your V-Ray installation, click the Advanced button. 

Advanced Installation

The Advanced Installation button takes you to the Additional Components screen. Here, you can choose whether to install the License Server or V-Ray Swarm and specify the License server machine.

Check the Help us improve V-Ray for Revit to help with software improvement. For more information on statistics data collection, visit the Chaos Telemetry page.

Click the Continue button to proceed with the installation


Optimize V-Ray for Revit installation by manually setting the location folder where V-Ray is installed. You can also enable distributed rendering via V-Ray Swarm upon installation. That way, you won't need to enable it from within the V-Ray for Revit UI.

Destination location – Specify an installation location for V-Ray for Revit.

V-Ray Material library – Specify a download location for the Materials Library and Cosmos Assets.

V-Ray Swarm Enabled – When enabled, after the installation is complete, V-Ray Swarm is activated by default.

The settings below become available after checking the V-Ray Swarm Enabled checkbox.

Don't use local machine – When enabled, the local machine is excluded from rendering. However, V-Ray Swarm continues to use a small percentage of the local machine's resources to communicate with the nodes.

Goal – Sets the desired percentage of utilization of available resources. Computers added to or removed from V-Ray Swarm are taken into account automatically.

Auto-Discovery – When enabled, the installation searches for other nodes in the network.

Tags – Tag this node with a descriptor that defines something about the machine and use it for selective control from inside of Revit. Separate each tag by a comma. For more information, check the Swarm page.


In this step, you can specify whether the V-Ray license server runs locally or on another machine.

  • If you select the Local licensing option, you need to install the License Server on your machine. See the Chaos License Quick Start Guide for a walkthrough.

  • If you select the Remote option, you have to fill in the IP address of your V-Ray license server in the field Primary License Server. Please leave the port 30304 unchanged. An Alternate License Server is used when the primary one does not respond.

V-Ray installation is successful.

Next Step

Go to step 2 to activate your Chaos License.

Was this helpful?