Versions Compared

Key

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

...

Before you run V-Ray, make sure that it can find a license. See the License setup section of this page.

Tabs Container
titleEnvironment variables
directionhorizontal
Tabs Page
titleWindows
UI Text Box
typeinfo

The example directory and version names below are for V-Ray 6 for Maya 2023 on Windows where vray_adv_60002_maya2023_x64.exe has been unpacked into D:\vray_builds\vray_60002_maya2023\.

Here is a list of the environment variables and their descriptions and examples. An example of a complete setup will be given further below.

OSAction

Variable

LocationDescriptionExample
WindowsExtendVRAY_FOR_MAYAnnnn_PLUGINS

<unpacked_location>\maya_vray\vrayplugins

Anchor
1.1
1.1

Needed for V-Ray Standalone.set VRAY_FOR_MAYA2023_PLUGINS=D:\vray_builds\vray_60002_maya2023\maya_vray\vrayplugins;%VRAY_FOR_MAYA2023_PLUGINS%
WindowsSetVRAY_AUTH_CLIENT_FILE_PATH 1 arbitrary locationPoints V-Ray to a V-Ray license.set VRAY_AUTH_CLIENT_FILE_PATH=<folder_containing_vrlclient.xml>



UI Expand
titleLegacy Variables for versions prior to V-Ray 6, update 1

If you are using a V-Ray version older than V-Ray 6, update 1, you also need to set the following variables

OSActionVariableLocationDescriptionExample
WindowsSetVRAY_OSL_PATH_MAYA nnnn<unpacked_location>\vray\openslLoads OSL plugins for V-Ray.set VRAY_OSL_PATH_MAYA2023=D:\vray_builds\vray_60002_maya2023\vray\opensl
Tabs Page
titleLinux
UI Text Box
typeinfo

The example directory and version names below are for V-Ray 6 for Maya 2023 on Linux where vray_adv_60002_maya2023_centos7 has been unpacked into /opt/vray_builds/vray_60002_maya2023/.

Here is a list of the environment variables and their descriptions and examples. An example of a complete setup will be given further below.

OSActionVariable

Location

DescriptionExample
LinuxExtend

VRAY_FOR_MAYAnnnn_PLUGINS

<unpacked_location>/maya_vray/vrayplugins

Anchor
1.1.1.1
1.1.1.1

Needed for V-Ray Standalone.export VRAY_FOR_MAYA2023_PLUGINS=/opt/vray_builds/vray_60002_maya2023/maya_vray/vrayplugins:$VRAY_FOR_MAYA2023_PLUGINS
LinuxSetVRAY_AUTH_CLIENT_FILE_PATH 1 arbitrary locationPoints V-Ray to a V-Ray license.export VRAY_AUTH_CLIENT_FILE_PATH=<folder_containing_vrlclient.xml>



UI Expand
titleLegacy Variables for versions prior to V-Ray 6, update 1

If you are using a V-Ray version older than V-Ray 6, update 1, you also need to set the following variables:

OSActionVariableLocationDescriptionExample
LinuxSetVRAY_OSL_PATH_MAYA nnnn<unpacked_location>/vray/openslLoads OSL plugins for V-Ray.export VRAY_OSL_PATH_MAYA2024=/opt/vray_builds/vray_60002_maya2023/vray/opensl
LinuxExtendLD_LIBRARY_PATH<unpacked_location>/vray/libRequired to run V-Ray itself.export LD_LIBRARY_PATH=/opt/vray_builds/vray_60002_maya2023/vray/lib:$LD_LIBRARY_PATH
Tabs Page
titlemacOS
UI Text Box
typeinfo

The example directory and version names below are for V-Ray 6 for Maya 2023 on macOS where vray_adv_60002_maya2023_mavericks_x64.app has been unpacked into /vray_builds/vray_60002_maya2023/.

Here is a list of the environment variables and their descriptions and examples. An example of a complete setup will be given further below.

OSActionVariable

Location

DescriptionExample

macOS

Extend

VRAY_FOR_MAYAnnnn_PLUGINS

<unpacked_location>/vray/VRay.App/Contents/MacOS/plugins

Anchor
1.2.1.2
1.2.1.2

Needed for V-Ray Standalone.

export VRAY_FOR_MAYA2023_PLUGINS=/vray_builds/vray_60002_maya2023/vray/VRay.App/Contents/MacOS/plugins:$VRAY_FOR_MAYA2023_PLUGINS

macOS

Set

VRAY_AUTH_CLIENT_FILE_PATH 1

arbitrary location

Points V-Ray to a V-Ray license.

export VRAY_AUTH_CLIENT_FILE_PATH=<folder_containing_vrlclient.xml>



UI Expand
titleLegacy Variables for versions prior to V-Ray 6, update 1

If you are using a V-Ray version older than V-Ray 6, update 1, you also need to set the following variables:

OSActionVariableLocationDescriptionExample
macOSSetVRAY_OSL_PATH_MAYA nnnn<unpacked_location>/vray/openslLoads OSL plugins for V-Ray.export VRAY_OSL_PATH_MAYA2023=/vray_builds/vray_60002_maya2023/vray/opensl
macOSExtendDYLD_LIBRARY_PATH<unpacked_location> /vray/lib
Required to run V-Ray itself.
export DYLD_LIBRARY_PATH=/vray_builds/vray_60002_maya2023/vray/lib:$DYLD_LIBRARY_PATH

...

The [STDROOT] and [PLUGINS] tags in the script are typically replaced with their respective directories by the V-Ray installer. However, if you are using a version earlier than V-Ray 6, update 1, and performing a portable installation, you need to manually replace these tags. The [STDROOT] tag needs to be replaced with the the full path to the vray folder in the portable file. The [PLUGINS] tag needs to be replaced with the full path to the maya_vray folder in the portable file. The tags are located in the following files:

...