Versions Compared

Key

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

...

Note that Chaos Cosmos is not included in the V-Ray for Maya Portable installation file. You can separately download and install Chaos Cosmos.

To use the Chaos Unified Login (a single login into whichever Chaos application grants access to all Chaos applications) with V-Ray portable installation, download and install separately. 

When using V-Ray from a Portable installation, the EULA needs to be accepted to start a render. A pop-up window will prompt you to accept the EULA the first time you start a render. Batch rendering is an exception to this.

 

UI Text Box
typeinfo

If you are using a V-Ray version older than V-Ray 6, please refer to the Installation from zip guide, as the Portable Installation is not available for those V-Ray versions.

...

Unpack the installation into a suitable location, which you can later use to run V-Ray on any computer. Here is a detailed step-by-step guide:

 

Tabs Container
directionhorizontal
Tabs Page
titleWindows

  1. Download the V-Ray installer executable (.exe).
  2. Open a Command Prompt. Type out: the location of the installer that you just downloaded -unpackInstall= location where you wish to unpack. Alternatively, you can drag and drop the installer and a target folder for unpacking into the Command Prompt to insert their directories. Press Enter to run the command. As an example, you can create a new folder called vray_builds to hold all portable V-Ray builds. Then, you can make other sub-folders and name them according to the V-Ray build version, for example vray_60002_maya2023 . It should look something like this:

    Code Block
    languagepowershell
    D:\Downloads\vray_adv_60002_maya2023_x64.exe -unpackInstall=D:\vray_builds\vray_60002_maya2023
    Section
    Column
    width30%

    After unpacking the installation, your folder structure should look like this:


    D:\vray_builds\
    ├── vray_60002_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\

    Column
    width10%

     

    Column
    width30%

    Here is an example with two different V-Ray 6 builds for Maya 2023 - each can be deployed with its own shell script and environment.

    D:\vray_builds\
    ├── vray_60002_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\
    ├── vray_60010_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\

    Column
    width20%

     

    UI Text Box
    typeinfo

    The D:\vray_builds location is an example. The Portable Installation can be placed anywhere.

  3. Set the necessary environment variables into a new Command Prompt and run V-Ray for Maya or V-Ray Standalone.

 

Tabs Page
titleLinux

  1. Download the V-Ray installer.
  2. Open a Terminal. Type out: the location of the installer that you just downloaded -unpackInstall= location where you wish to unpack. Alternatively, you can drag and drop the installer and a target folder for unpacking into the Terminal to insert their directories. Press Enter to run the command. As an example, you can create a new folder called vray_builds to hold all portable V-Ray builds. Then, you can make other sub-folders and name them according to the V-Ray build version, for example vray_60002_maya2023 . It should look something like this:

    Code Block
    languagepowershell
    /home/user/Downloads/vray_adv_60002_maya2023_centos7 -unpackInstall=/opt/vray_builds
    Section
    Column
    width30%

    After unpacking the installation, your folder structure should look like this:


    /opt/vray_builds/
    ├── vray_60002_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\

    Column
    width10%

     

    Column
    width30%

    Here is an example with two different V-Ray 6 builds for Maya 2023 - each can be deployed with its own shell script and environment.

    /opt/vray_builds/
    ├── vray_60002_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\
    ├── vray_60010_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\

    Column
    width20%

     

    UI Text Box
    typeinfo
    The  /opt/vray_builds  location is simply an example. The Portable Installation can be unpacked anywhere.
  3. Set the necessary environment variables into a new Terminal and run V-Ray for Maya or V-Ray Standalone.

 

Tabs Page
titlemacOS

  1. Download the V-Ray installer .dmg file and double-click to mount it. By default, it mounts to /Volumes.
  2. Open a Terminal and type out /path/to/run_installer -unpackInstall=</unpack/target/location>.
    As an example, you can create a new folder called  vray_builds  in your root directory to hold all portable V-Ray builds. Then, you can make other sub-folders and name them according to the V-Ray build version, for example  vray_60002_maya2023 . An example unpacking command should look like this:

    Code Block
    languagepowershell
    /Volumes/V-Ray\ for\ Maya\ 2023/vray_adv_60002_maya2023_mavericks_x64.app/Contents/MacOS/run_installer -unpackInstall=/vray_builds/vray_60002_maya2023
    Section
    Column
    width30%

    After unpacking the installation, your folder structure should look like this:


    /vray_builds/
    ├── vray_60002_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\

    Column
    width10%

     

    Column
    width30%

    Here is an example with two different V-Ray 6 builds for Maya 2023 - each can be deployed with its own shell script and environment.

    /vray_builds/
    ├── vray_60002_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\
    ├── vray_60010_maya2023\
    │ ├── maya_root\
    │ ├── maya_vray\
    │ └── vray\

    Column
    width20%

     

    UI Text Box
    typeinfo
    The  /vray_builds  location is simply an example. The Portable Installation can be unpacked anywhere.
  3. Set the necessary environment variables into a new Terminal and run V-Ray for Maya or V-Ray Standalone.

 

...

The list or variables to set requires unpacking the same installation build. Read the Unpacking the installation file section for more details.

 

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\vraypluginsNeeded for V-Ray Standalone.set VRAY_FOR_MAYA2023_PLUGINS=D:\vray_builds\vray_60002_maya2023\maya_vray\vrayplugins;%VRAY_FOR_MAYA2023_PLUGINS%
WindowsSetVRAY_OSL_PATH_MAYAnnnn

<unpacked_location>\vray\opensl

Anchor
1.1
1.1

Loads OSL plugins for V-Ray.set VRAY_OSL_PATH_MAYA2023=D:\vray_builds\vray_60002_maya2023\vray\opensl
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>
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/vraypluginsNeeded for V-Ray Standalone.export VRAY_FOR_MAYA2023_PLUGINS=/opt/vray_builds/vray_60002_maya2023/maya_vray/vrayplugins:$VRAY_FOR_MAYA2023_PLUGINS
LinuxSet

VRAY_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
LinuxExtend

LD_LIBRARY_PATH

<unpacked_location>/vray/lib

Anchor
1.1.1.1
1.1.1.1

Required to run V-Ray itself.

export LD_LIBRARY_PATH=/opt/vray_builds/vray_60002_maya2023/vray/lib:$LD_LIBRARY_PATH

LinuxSetVRAY_AUTH_CLIENT_FILE_PATH 1.1 arbitrary locationPoints V-Ray to a V-Ray license.export VRAY_AUTH_CLIENT_FILE_PATH=<folder_containing_vrlclient.xml>
Tabs Page
titlemacOS
Tabs Page
titleLinux
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
macOSExtendVRAY_FOR_MAYAnnnn_PLUGINS <unpacked_location>/vray/VRay.App/Contents/MacOS/pluginsNeeded for V-Ray Standalone.export VRAY_FOR_MAYA2023_PLUGINS=/vray_builds/vray_60002_maya2023/vray/VRay.App/Contents/MacOS/plugins:$VRAY_FOR_MAYA2023_PLUGINS
macOSSet

VRAY_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
macOSExtend

DYLD_LIBRARY_PATH

<unpacked_location> /vray/lib

Anchor
1.2.1.2
1.2.1.2

Required to run V-Ray itself.

export DYLD_LIBRARY_PATH=/vray_builds/vray_60002_maya2023/vray/lib:$DYLD_LIBRARY_PATH

macOSSetVRAY_AUTH_CLIENT_FILE_PATH 1.2 arbitrary locationPoints V-Ray to a V-Ray license.export VRAY_AUTH_CLIENT_FILE_PATH=<folder_containing_vrlclient.xml>

...