Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  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 (20132018, 20142017, etc. Note that the environment variable name for Maya 2016.5 will be VRAY_FOR_MAYA2016_5_MAIN_x64).

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

    titleOut-of-process IPR

    Should you need to use out-of-process IPR, although it is highly unlikely, you will need to set the VRAY_PLUGINS_x64 environment variable to the folder vray_builds/my_version/maya_vray/vraypluginsAlternatively, you can edit vray_builds/my_version/maya_vray/bin/vrayconfig.xml and set [PLUGINS]/vrayplugins to be vray_builds/my_version/maya_vray/vrayplugins.

  4. Set the VRAY_AUTH_CLIENT_FILE_PATH environment variable to point to the folder that contains the vrlclient.xml file with the V-Ray license server settings (IP address and port number). Alternatively, using the tool to set or change your license settings will create the vrlclient.xml file for you at a default location and there will be no need to explicitly define its location with an environment variable. Using the VRAY_AUTH_CLIENT_FILE_PATH variable, however, is useful to set per-user license settings and also when V-Ray is started with a script that defines this entire environment setup.

    For the case where using the environment variable is the best option for you and you need to create the vrlclient.xml file manually, the example below shows what it should contain: 

    Code Block
    titleExample: vrlclient.xml
    	Example contents of vrlclient.xml
    	In this example, the primary IP address to look for a valid license is at the default 30304 port.
    	Alternate servers (hosts) have not been set.
  5. 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).

  6. Add paths to path variables based on the OS:

    Fancy Bullets
    • 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 DYLD_LIBRARY_PATH environment variable the path to the vray_builds/my_version/maya_root/ folder.

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

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

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

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

    titleLinux specific

     The syntax is slightly different for Linux: %B must be added at the end, for example, vray_builds/my_version/maya_vray/icons/%B

  11. You can now run Maya.


Here is a sample Maya.env file for Maya 2017 2018 on Windows, where the .zip installation has been extracted to D:\vray_builds\vray_adv_3520136001_maya2017maya2018_x64. Place the file in C:\Users\<username>\Documents\maya\20172018 or combine its contents with the already existing Maya.env that you will find there, in case the original file is not empty.


Setup for XGen

If you want to use the VRScene mode for XGen for Maya 2014.5+ there are a few more steps. These steps 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/ by using this text in the file:

    Code Block
    LocalRepo D:/vray_builds/vray_adv_3300236001_maya2015maya2018_x64/maya_root/plug-ins/xgen/presets/
  2. Set the XGEN_CONFIG_PATH environment variable to point to the folder that contains the config.txt file.