You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »


Page Contents


Installing V-Ray for Maya from a .zip file provides several advantages:

  • If you run the normal installation multiple times, environment variables will be overwritten even if you use different NUKE installations. Using the ZIP installation gives you the option to set custom environment variables when starting a each NUKE instance.
  • The ZIP installation can be extracted to a network drive. That way, multiple users can start NUKE with V-Ray for NUKE using just a script that sets up the environment variables without the need to run local installations. Upgrading such an installation is a lot easier too, as you don't need to run the installer at every users' computer.
  • Sometimes users need to be able to quickly switch between different V-Ray versions without having to constantly reinstall it. In this case, you can use the ZIP file to install and run both V-Ray for Maya and V-Ray Standalone from arbitrary locations on your machine or local network.

This page describes how to set up your local system so that it loads the files for the correct version. The notes here are for the Windows, Linux and MAC OS X operating systems.


Unpacking the Contents of the .zip File

Extract the contents of the relevant .zip file into a suitable folder, for example, vray_builds/my_version . After the extraction, there should be three sub folders in it: maya_root , maya_vray and vray .


Running Maya

Before you run Maya, you need to perform the following steps:

  1. If you plan to use batch rendering, set the environment variable MAYA_RENDER_DESC_PATH to the folder vray_builds/my_version/maya_root/bin/rendererDesc

  2. Set the VRAY_FOR_MAYAnnnn_MAIN_x64 environment variable to point to the vray_builds/my_version/maya_vray folder where nnnn is the Maya version (2013, 2014, etc.).

  3. Set the VRAY_FOR_MAYAnnnn_PLUGINS_x64 environment variable to point to the folder vray_builds/my_version/maya_vray/vrayplugins

  4. Set the VRAY_OSL_PATH_ MAYAnnnn_x64 environment variable to point to the folder  vray_builds/my_version/vray/opensl  (if the particular V-Ray version supports OSL)

  5. On Linux, add to the LD_LIBRARY_PATH environment variable the path to the vray_builds/my_version/maya_root/lib folder; on Windows, add to the PATH environment variable the path to the vray_builds/my_version/maya_root/bin folder, on OSX add to the DY LD_LIBRARY_PATH environment variable the path to the vray_builds/my_version/maya_root/ folder

  6. Add to the MAYA_PLUG_IN_PATH variable the folder vray_builds/my_version/maya_vray/plug-ins

  7. Add to the MAYA_SCRIPT_PATH variable the folder vray_builds/my_version/maya_vray/scripts

  8. Add to the PYTHONPATH variable the folder vray_builds/my_version/maya_vray/scripts to be able to use V-Ray's python modules

  9. Add to the XBMLANGPATH variable the folder vray_builds/my_version/maya_vray/icons/

    Linux specific

     the syntax is slightly different for Linix, %B must be added at the end, f.e. vray_builds/my_version/maya_vray/icons/%B

  10. Edit vray_builds/my_version/maya_vray/bin/vrayconfig.xml and set <PluginsPath> to be vray_builds/my_version/maya_vray/vrayplugins to be able to use IPR

  11. You can now run Maya.


XGen specific

If you want to use the VRScene mode for XGen for Maya 2014.5+ there are a few more steps.
They are NOT required for direct rendering of XGen in Maya 2015+.

  1. create a config.txt file with a path to the vray_builds/my_version/maya_root/plug-ins/xgen/presets/ like this:

    LocalRepo D:/vray_builds/vray_adv_33002_maya2015_x64/maya_root/plug-ins/xgen/presets/
  2. Set the XGEN_CONFIG_PATHenvironment variable to point to the folder that contains the config.txt file

Here is a sample Maya.env file for windows: Maya.env


Running V-Ray Standalone

Before running V-Ray Standalone, you need to perform the following steps:

  1. Add to the PATH environment variable the folder
    vray_builds/my_version/maya_vray/bin (this is required for running V-Ray itself)
    vray_builds/my_version/vray/bin (if you want to use any additional tools like the irradiance map viewer, the VRIMG to OpenEXR converter etc.).

  2. On Linux, add to the LD_LIBRARY_PATH environment variable the folder

  3. Set the VRAY_PLUGINS_x64 environment variable to the folder

  4. Set the VRAY_OSL_PATH _x64 environment variable to point to the folder  vray_builds/my_version/vray/opensl

  5. You can now run the vray command.



  • Previous installations required users to set the VRAY_AUTH_CLIENT_FILE_PATH environment variable to point to a vrlclient.xml file, which contained the V-Ray license server settings. This step is no longer necessary since it is covered when installing the V-Ray License Server. For more information, see the Installing the License Server section of the Installation of V-Ray for Maya page.