Installation and LicensingV-Ray for SketchUp

V-Ray for SketchUp

Silent Installation

This page provides information on how to silently install V-Ray.

Last updated 13 June 2026

This page provides information on how to silently install V-Ray.

Overview

A silent installation allows you to perform a complete V-Ray installation without any user input during the process, using either the default options (automatic installation) or, if desired, a predefined set of options (manual installation).

To use the default options, you need to run the installer file from the command prompt with the -auto argument. This option forces the installer to run without a user interface, and also automatically selects all the default options. A config file, containing the default installation options, is created at the end of the process.

To use a predefined set of options, you need to first create a configuration xml file that stores the installation parameters and then run the installer. You must use the -gui=0 argument, which indicates to the installer that no visual dialog will be shown and all interactions will occur through the console. After that, you can set each of the installation options directly in the console. Adding the -quiet=1 argument speeds this process by skipping the full output and leading you straight to the configuration options where you can set them as you prefer. When this process is finished, the config.xml file is created. The final step is to run the installer again in the command prompt with the config.xml file.

You can remove V-Ray from your machine similarly through a silent uninstall.

Steps

Windows

To set up a silent installation, follow the instructions below.

Run the installation file from the command prompt with the -gui=0 argument:
vray_adv_70001_sketchup_win.exe -gui=0To suppress the full console output and speed up the generation of a config file, add the -quiet=1 argument.
vray_adv_70001_sketchup_win.exe -gui=0 -quiet=1
Follow the instructions of the installer and set up the installation the way you want to have it on all machines. This creates a file named config.xml in the folder of the installation file.
Run the installer with the following command:
vray_adv_70001_sketchup_win.exe -gui=0 -configFile="config.xml" -quiet=1The part of the config.xml file between “<LicServer>” and "</LicServer>" tags specifies the V-Ray license settings. If this section exists in the config.xml file, existing license settings will be overwritten. If you already have the correct license settings in place, you can remove the <LicServer></LicServer> part from the .config.xml, so that the existing settings won't be changed.

macOS

In the terminal, navigate to the location where you have mounted the vray_adv_70001_sketchup_osx.dmg file (by double-clicking on it). The default location is /Volumes/V-Ray for SketchUp/.
Using the "cd" command to navigate inside the .app file and go to /Volumes/V-Ray for SketchUp/vray_adv_70001_sketchup_osx.app/Contents/macOS
Use the vray_adv_70001_sketchup_osx.bin file to run a command-line installation. Copy the file to a custom location where your user has “write” permissions and run it from there.
Create a config .xml file with installation options. To do that, start the installation on a single machine by entering in the terminal the following: ./vray_adv_70001_sketchup_osx.bin -gui=0
You are then prompted to enter your password.
Follow the instructions of the installer and set up the installation the way you want it to be for all machines. Make sure SketchUp has been run on the machine at least once prior to installing V-Ray.
A file named config.xml will be created in the same folder the .bin file is located. Please note that if you start the installation directly from inside vray_adv_70001_sketchup_osx.app/Contents/macOS directory, no config.xml file will be written since the location is read-only.
You can now install V-Ray on all machines by navigating to the location of vray_adv_70001_sketchup_osx.bin and running:

./vray_adv_70001_sketchup_osx -configFile="config.xml" -gui=0 -quiet=1 -ignoreErrors=1

The part of the config.xml file between “<LicServer>” and "</LicServer>" tags specifies the V-Ray license settings. If this section exists in the config.xml file, existing license settings will be overwritten. If you already have the correct license settings in place, you can remove the <LicServer></LicServer> part from the .config.xml, so that the existing settings won't be changed.

V-Ray will search for $HOME/Library/Application Support/SketchUp 20xx (where 20xx is the SketchUp version) folder that is created after the first time SketchUp is started. Since this is per user, if you use "root" user to deploy installations, copy the existing $HOME/Library/Application Support/SketchUp 20xx folder into /var/root/Library/Application Support/ before installing. Otherwise, V-Ray will not detect that a specific SketchUp version is installed.

Installer Arguments

Below is a description of the common variables that can be defined in the .xml file:

-help

Prints available arguments for the installer executable.

-help	Prints available arguments for the installer executable.
-configFile	Specifies path to an installation configuration file.
-gui	Specifies if a Graphic User Interface or a command line one is used during installation: 0 – No Graphic User Interface is visible, installation is in command line. 1 – Installation is with a Graphic User Interface.
-debug	Specifies the level of debug logging by the installer. Defaults to 0 and assumes a value of 1 if argument is provided with no value.
-auto	Specifies if the installation is automatic with default settings and forces the -quiet=1 argument. If you perform an automatic installation and use the Software , you accept the terms of the EULA and the Global Consumer Privacy Policy.
-quiet	Specifies whether the automatic installation prints the output to the console. Defaults to 1. 0 – Installation prints all of its output to the console. 1 – Installation suppresses the log output.
-backup	Specifies whether the installer performs backup on previous installation. 0 – Previous installation is not backed up. 1 – Previous installation is backed up.

Configuration File

The config.xml file configures the automated installation. Below is an example of a config file.

<code data-v-c2b1f83f=""><DefValues> <Value Name="INSTALLER_LANGUAGE" DataType="value">0</Value> <Value Name="INSTALL_SKETCHUP_2024" DataType="value">0</Value> <Value Name="INSTALL_SKETCHUP_2022" DataType="value">0</Value> <Value Name="INSTALL_SKETCHUP_2021" DataType="value">0</Value> <Value Name="INSTALL_CLOUD" DataType="value">0</Value> <Value Name="ANONYMIZED_TELEMETRY" DataType="value">1</Value> <Value Name="INSTALL_GALAXY" DataType="value">0</Value> <Value Name="INSTALL_SWARM" DataType="value">0</Value> <Value Name="OPEN_CHANGELOG" DataType="value">0</Value> <Value Name="CONFIGURE_LICENSE_ONLY" DataType="value">0</Value> <Value Name="REMOTE_LICENSE" DataType="value">1</Value> <Value Name="AUTO_INSTALL" DataType="value">0</Value> <Value Name="PERSONALIZED_TELEMETRY" DataType="value">0</Value> <Value Name="INSTALL_LICENSE_SERVER" DataType="value">0</Value> <Value Name="LOGIN_LICENSE_SERVER" DataType="value">1</Value> <Value Name="INSTALL_ULA" DataType="value">0</Value> <Value Name="INSTALL_SKETCHUP_2023" DataType="value">1</Value> <LicServer> <Host>127.0.0.1</Host> <Port>30304</Port> <Host1>localhost</Host1> <Port1>30304</Port1> <Host2></Host2> <Port2>30304</Port2> <User></User> </LicServer></DefValues></code>

Below is a description of the common variables that can be defined in the .xml file:

OPEN_CHANGELOG

Specifies whether or not to open the Change Log once the installation is complete:

0 - Does not open the Change Log

1 - Opens the Change Log

OPEN_CHANGELOG	Specifies whether or not to open the Change Log once the installation is complete: 0 - Does not open the Change Log 1 - Opens the Change Log
REMOTE_LICENSE	Specifies whether the V-Ray license server runs locally or on another machine: 0 - The license server runs locally on the same machine 1 - The server is on a different machine in the network
REG_LIC_SERVER	Specifies whether to register the V-Ray license server: 0 - Does not register the V-Ray license server 1 - Registers the V-Ray license server
INSTALL_SKETCHUP_2024	Specifies the installation of V-Ray for SketchUp 2024: 0 - Does not install V-Ray for SketchUp 1 - Installs V-Ray for SketchUp
INSTALL_LICENSE_SERVER	Specifies whether or not to install the V-Ray license server: 0 - Does not install the V-Ray license server 1 - Install the V-Ray license server
INSTALL_SWARM	Specifies whether or not to install V-Ray Swarm: 0 - Does not install Swarm 1 - Installs Swarm
ANONYMIZED_TELEMETRY	Specifies whether to enable telemetry for the most used product functionality and/or parameter values. The data is not personally identifiable and is not tied to the user's individual account: 0 - Anonymous telemetry is disabled. 1 - Anonymous telemetry is enabled.
PERSONALIZED_TELEMETRY	Specifies whether to enable telemetry for the most used product functionality, parameter values, but also contains personally identifiable information tied to an individual user's license: 0 - Personalized telemetry is disabled. 1 - Personalized telemetry is enabled.
INSTALL_CLOUD	Specifies whether or not to install Chaos Cloud Client App: 0 - Does not install Chaos Cloud Client App 1 - Installs Chaos Cloud Client App

Notes

The V-Ray installer should not be run using administrative privileges.

Overview

Steps

Windows

macOS

Installer Arguments

Configuration File

Notes

Related articles

Chaos License Quick Start Guide

Chaos Telemetry

End User License Agreement

Free Trial

Installation