This page provides information on installing V-Ray for Maya.
Overview
This guide is to serve as a reference for installation of V-Ray 5.0 for Maya. Please refer to the Glossary section for specific terms used in this document.
You can download the latest official version of V-Ray 5.0 from http://www.chaosgroup.com with the account supplied to you by Chaos Group or your reseller.
If you experience any problems, please check the Troubleshooting section.
See how to install V-Ray for Maya from a .zip file at Installation from zip.
A complete installation of V-Ray 5.0 for Maya consists of:
V-Ray
V-Ray IPR
V-Ray Standalone
V-Ray license server
- Chaos Cloud Client App
V-Ray tools
V-Ray SDK
V-Ray AppSDK
In order to complete a full installation of V-Ray 5.0 for Maya you need to:
Install the License Server or connect to one on your network
Install V-Ray for Maya
All necessary installation files can be found in the V-Ray 5.0 for Maya installation archive.
Use the latest version of the Chaos License Server with the latest version of V-Ray.
Installing V-Ray for Maya
This section describes the installation of V-Ray for Maya using the provided installer.
Windows
The V-Ray installer will automatically remove any previous installations. This will allow you to seamlessly upgrade from previous versions. If you experience problems you can manually uninstall the previous versions to perform a clean install. For more information please refer to the Uninstall V-Ray page.
Before running the installation, make sure your Windows account has administrative privileges.
Run the installer.
1. Upon the start of the installation, Windows may ask you for permission to run the installer with administrator privileges. Please confirm.
2. You will be presented with the V-Ray licensing agreement. Please take a moment to review the agreement. Check the I accept the Agreement checkbox and click Install to proceed with standard installation.
If you need to customize your V-Ray installation, press the Advanced button.
V-Ray type
The available installation types are:
Full – This is a full installation and includes all components as described in the “Installation overview” section. It will allow you to use V-Ray in Maya do Distributed or Network Rendering, run IPR render server, use V-Ray SDK, and have V-Ray license server on this machine.
Standalone only – An installation which includes V-Ray Standalone and IPR render server. Please choose this option if you plan to use this machine only for Distributed Rendering with V-Ray Standalone and an IPR render server.
Add firewall exceptions – Automatically adds firewall exceptions so IPR for Maya and V-Ray Standalone can run uninterrupted.
Directories & Feedback
Here you can specify the installation paths. Please check if the default folders are correct.
Help make V-Ray even better – Participate in the improvement decisions for future version of V-Ray. No intelligence property is violated when agreeing to participate in the feedback program. We do not gather scenes, assets, materials, etc. What we receive is user preferences on just a few key render settings and the resulting render times. The point of this feature is to improve V-Ray's performance and the user experience. This preference can be changed at any time later on from the V-Ray Render Settings > Settings > About V-Ray > Feedback program settings. For more information, see the Chaos Group Telemetry page.
Licensing
In this step, you can specify whether the V-Ray license server will run locally or on another machine.
If you select the option Remote you will 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.
3. After you click the Install button, the installer will proceed to uninstall any previous versions and install V-Ray on your machine.
If the installer detects any applications that need to be closed, they will be listed before being able to continue. Please close them and click Continue.
4. Now V-Ray 5 is ready to render!
Mac OS X
The V-Ray installer will automatically remove any previous installations. This will allow you to seamlessly upgrade from previous versions. If you experience problems you can manually uninstall the previous versions to perform a clean install. For more information please refer to the Uninstall V-Ray page.
| Operating system | Maya Version | Installer Name |
| Mac OS X 64-bit | Maya 2016 | vray_adv_50000_maya2016_mavericks_x64.app |
| Mac OS X 64-bit | Maya 2016 Ext. 2 | vray_adv_50000_maya2016.5_mavericks_x64.app |
| Mac OS X 64-bit | Maya 2017 | vray_adv_50000_maya2017_mavericks_x64.app |
| Mac OS X 64-bit | Maya 2018 | vray_adv_50000_maya2018_mavericks_x64.app |
| Mac OS X 64-bit | Maya 2019 | vray_adv_50000_maya2019_mavericks_x64.app |
Before running the installation, make sure your Mac OS account has administrative privileges.
Run the installer.
1. Upon the start of the installation, Mac OS may ask you for permission to run the installer with administrator privileges. Please confirm.
2. You will be presented with the V-Ray licensing agreement. Please take a moment to review the agreement. Check the I accept the Agreement checkbox and click Install to proceed with standard installation.
If you need to customize your V-Ray installation, press the Advanced button.
V-Ray type
The available installation types are:
Full – This is a full installation and includes all components as described in the “Installation overview” section. It will allow you to use V-Ray in Maya do Distributed or Network Rendering, run IPR render server, use V-Ray SDK, and have V-Ray license server on this machine.
Standalone only – An installation which includes V-Ray Standalone and IPR render server. Please choose this option if you plan to use this machine only for Distributed Rendering with V-Ray Standalone and an IPR render server.
Add firewall exceptions – Automatically adds firewall exceptions so IPR for Maya and V-Ray Standalone can run uninterrupted.
Directories & Feedback
Here you can specify the installation paths. Please check if the default folders are correct.
Help make V-Ray even better – Participate in the improvement decisions for future version of V-Ray. No intelligence property is violated when agreeing to participate in the feedback program. We do not gather scenes, assets, materials, etc. What we receive is user preferences on just a few key render settings and the resulting render times. The point of this feature is to improve V-Ray's performance and the user experience. This preference can be changed at any time later on from the V-Ray Render Settings > Settings > About V-Ray > Feedback program settings. For more information, see the Chaos Group Telemetry page.
Licensing
In this step, you can specify whether the V-Ray license server will run locally or on another machine.
If you select the option Remote you will 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.
3. After you click the Install button, the installer will proceed to uninstall any previous versions and install V-Ray on your machine.
If the installer detects any applications that need to be closed, they will be listed before being able to continue. Please close them and click Continue.
4. Now V-Ray 5 is ready to render!
Linux
1. Unpack the contents of the installation archive to a temporary folder (called vray_install_dir below);
2. Open a console and navigate to that folder;
3. Make sure you have root permissions or use the su or the sudo command and run the installation file in the directory for the respective Maya version:
Operating system | Maya version | Installer name |
| Linux 64-bit | Maya 2016 | vray_adv_50000 _maya2016_linux_x64 |
| Linux 64-bit | Maya 2016 Ext. 2 | vray_adv_50000 _maya2016.5_linux_x64 |
| Linux 64-bit | Maya 2017 | vray_adv_50000 _maya2017_linux_x64 |
| Linux 64-bit | Maya 2018 | vray_adv_50000 _maya2018_linux_x64 |
| Linux 64-bit | Maya 2019 | vray_adv_50000 _maya2018_linux_x64 |
4. Follow the instructions of the installer; if you had a previous version of V-Ray for Maya, the installer will try to automatically remove it first.
For example:
$ cd vray_install_dir
$ sudo ./vray_adv_50000_maya2018_linux_x64
follow installer instructions
$ exit
5. You will be presented with the V-Ray licensing agreement. Please take a moment to review the agreement. Check the I accept checkbox and click Next to proceed.
6. During the next step you can choose the installation type. The available installation types are:
Full – A full installation and includes V-Ray for Maya, IPR for Maya, V-Ray Standalone, V-Ray SDK, V-Ray Tools and Documentation. It will allow you to use V-Ray in Maya, do Distributed or Network Rendering, run IPR, use V-Ray SDK, and use the different V-Ray Tools.
Standalone only – An installation which includes V-Ray Standalone and IPR render server. Please choose this option if you plan to use this machine only for Distributed Rendering with V-Ray Standalone and an IPR render server.
7. After you choose the installation type you can click the Customize button and adjust the corresponding installation settings. If you have selected the Full installation, you will see the full list of customizable settings:
Uninstall previous installations – Leave enabled to automatically uninstall any previous versions.
Install Chaos Cloud Client – Enable this option to start installation of Chaos Cloud Client. By default this option is enabled. If the installer detects a Chaos Cloud Client app on your machine, this option shows as disabled.
How are you going to connect to the V-Ray license server – Specifies whether the V-Ray license server will run locally or on another machine. If you select “Remote V-Ray license server on the network” you will be given fields to specify the IP address of the machine on which the V-Ray License server is running. Please leave the port 30304 unchanged.
Specify installation paths – Use to confirm the default folders are correct.
Common settings for Full installation for Maya 20xx with a local license server and default paths, should look like the screenshot below:
8. If the installation was successful, you will get this screen.
Register the V-Ray render slave – Registers V-Ray Standalone as a service and automatically start when the machine boots. In this case the V-Ray Standalone server will run in the background as a service and there will be no need to run it manually. You will be able to use this machine as a render slave.
9. Press the Finish button.
If you opted for Chaos Cloud Client installation, it will start right after the V-Ray installation.
Some GUI Distributions of Linux may be incompatible with the GUI of the installer. In that case run the installation with -gui=0 attribute.
For example:
$ cd vray_install_dir
$ sudo ./vray_adv_50000_maya2018_linux_x64 -gui=0
follow installer instructions
$ exit