Overview
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
- Online Licensing Documentation
- V-Ray Swarm
- Chaos Cloud Client app
- Chaos Cosmos Browser service
- Chaos Unified Login
Run the provided installer for a complete installation of V-Ray for Revit.
Please refer to the Trial installation page for installing a trial version, as the process differs from the one showed on this page.
Installation Steps
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.
Before running the installation, make sure your Windows account has administrative privileges.
| Revit Version | Installer Name |
|---|---|
| Revit 2024 x64 | vray_adv_61003_revit_win_x64.exe |
| Revit 2023 x64 | vray_adv_52023_revit_win_x64.exe |
| Revit 2022 x64 | vray_adv_52023_revit_win_x64.exe |
| Revit 2021 x64 | vray_adv_52023_revit_win_x64.exe |
| Revit 2020 x64 | vray_adv_52023_revit_win_x64.exe |
| Revit 2019 x64 | vray_adv_52023_revit_win_x64.exe |
To start the installation, double-click the installation file.
1. Please take a moment to read the license agreement. Select I Agree to continue.
2. Select the required Revit version. The option to select multiple versions at once is also available.
Press the Install button to proceed with standard installation. Press the Advanced button for more customization options. The Advanced menu provides options for installing the License Server and V-Ray Swarm and allows for specification of the License server machine.
Additional Components
In this step you can opt to install the License Server and V-Ray Swarm. Press the Continue button to proceed with the installation. Check the V-Ray Swarm page for setting up V-Ray Swarm from its designated installer.
Settings
Optimize V-Ray for Revit installation by manually setting the location folder where V-Ray is installed. V-Ray Swarm "on" and "off" functions are also available here.
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.
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.
Licensing
Specify whether the V-Ray License Server runs locally or on another machine.
The Remote option requires the IP address of your V-Ray license server to be filled in the Primary License Server field. Please, leave the port 30304 unchanged. An Alternate License Server is used when the primary one does not respond.
3. The installer first checks for running applications and prompts you to stop them, if there are such. Then it automatically uninstalls all old versions.
4. Installation is completed. On the last screen resides the usage statistics collection option. See the Chaos Telemetry page for more information or select the Open the release notes file option to open the release notes file after the installation.
Check Your License
Once the installation of the License Server is complete, you are directed to the License Server local host (127.0.0.1:30304) in order to sign in and activate it.
The License Server skips its installation process for two reasons:
- If it detects a previous installation of the Online License Server on your machine.
- If you choose the option Remote V-Ray license server on the network.
For full information on the License Server options and settings, see the Licensing section of the documentation.
Running V-Ray for the first time
By default, when Revit is launched, the V-Ray for Revit license is not automatically engaged and the V-Ray toolbar is grayed out.
To pull your license and start using V-Ray, press the Enable V-Ray button. When Revit is closed, your V-Ray license will be released automatically.
If you prefer your V-Ray license to be engaged automatically every time when Revit is loaded, use the Obtain License on start-up option.
