Page History

• The Portable installation allows for setting a custom environment when starting each instance. To compare, running the regular installation multiple times overwrites the V-Ray environment variables.

• The Portable installation can be used to run V-Ray and V-Ray Standalone from any location or even a network drive. That way, multiple users can start V-Ray and V-Ray Standalone using just a script that sets up the environment variables without the need to run local installations.

• Upgrading a Portable installation is a lot easier too, as you don't need to run the installer on every user's computer.

• The Portable installation allows for quick switching between different V-Ray Standalone versions without reinstalling it.

When using V-Ray from a Portable installation, the EULA needs to be accepted to start a render.

Required steps to run V-Ray Standalone

To create a Portable installation, you need to:

1. Download a V-Ray Standalone installation file. Click the button to do so.

2. Unpack the installation file. See the Unpack the installation file section of this page for more information.

3. Set up the environment variables needed to run V-Ray Standalone. See the Environment setup section of this page for more information.

4. Set up your license. Visit the Licensing section to find out how.

5. Run V-Ray Standalone.

Unpacking the installation file

NOTE that the cases here show example versions of V-Ray Standalone. The version you are using might differ.

Unpacking the installation creates three folders in your specified location, which you can later use to install V-Ray Standalone on any computer and in any location you like. Here is a detailed step-by-step guide:

C:/Users/Username/Downloads/vraystd_adv_61003_x64_vc14.exe -unpackInstall=<chosen_location>

/home/Username/Downloads/vraystd_adv_61003_centos7_clang-gcc-6.3 -unpackInstall=<chosen_location>

hdiutil attach vraystd_adv_61003_maverics_x64_gcc-4.2-cpp.dmg

/Volumes/V-Ray\ Standalone\ mavericks_x64/vraystd_adv_61003_mavericks_x64_gcc-4.2-cpp.app/Contents/MacOS/run_installer -unpackInstall=<chosen_location>

Environment setup

Before you run V-Ray Standalone, you need to set up an environment. There are some specific steps to consider. The license setup is the last requirement, as V-Ray needs to be instructed where to look for a valid license.

Please read the sections below for more information and examples.

Tags

---

The [STDROOT] and [PLUGINS] tags in the script are normally replaced with their respective directories by the V-Ray installer. However, but when if you are using a version earlier than V-Ray 6, update 1, and performing a portable installation, you need it is necessary to manually replace them manuallythese tags. The  The [STDROOT] tag needs to be replaced with 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:

 

Section

Column width 50% Linux and MacOS: maya_vray/vray/VRay.app/Contents/MacOS/vray.bin maya_vray/vray/VRay.app/Contents/MacOS/vrayserver vray/vray_netinstall_client_setup.sh vray/samples/appsdk/setenv39.sh vray/bin/vraymayaserver.conf vray/bin/registerVRayServerDaemon vray/bin/initVRayServerDaemon vray/bin/vraymayaserver.service maya_vray/bin/plgparamsdata Column width 50% Windows: maya_vray/bin/plgparamsdata

 

If you want to use any additional tools like the standalone denoiser, or the VRIMG to OpenEXR converter, etc., then also add <unpacked_location>/vray/bin to the PATH environment variable.

Please note that by default the V-Ray installer will set the TdrLevel (that is GPU timeout detection and recovery) to 0 (disabled).

 

Notes

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:

 <!--
	Example contents of vrlclient.xml
	In this example, the primary IP address to look for a valid license is 10.0.0.100 at the default 30304 port.
	Alternate servers (hosts) have not been set.
-->
<VRLClient>
	<LicServer>
		<Host>10.0.0.100</Host>
		<Port>30304</Port>
		<Host1></Host1>
		<Port1>30304</Port1>
		<Host2></Host2>
		<Port2>30304</Port2>
		<User></User>
		<Pass></Pass>
	</LicServer>
</VRLClient>