---
title: "Silent Installation"
canonical: "https://documentation.chaos.com/space/VSKETCHUP/109779875/Silent%20Installation"
format: markdown
---
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.

> ⚠️ By using the Chaos installer for automatic installation with the **-auto** argument, you accept the <u>[Chaos End User License Agreement](https://www.chaos.com/terms)</u> and the <u>[Chaos Global Consumer Privacy Policy](https://www.chaos.com/privacy)</u>.

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.

> ℹ️ The **-auto** argument generates a configuration file using the default installation settings.
> ℹ️ 
> ℹ️ The **-gui=0** **-quiet=1** arguments generate a configuration file with installation settings that you specify.
> ℹ️ 
> ℹ️ You can inspect the configuration.xml files with a text editor and further modify the options listed there to suit your needs.

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


## **Steps**

---

<details>
<summary>Windows</summary>

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

1. Run the installation file from the command prompt with the **-gui=0** argument:  
***vray_adv_70001_sketchup_win.exe -gui=0***
  To 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***
2. 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.
3. Run the installer with the following command:  
***vray_adv_70001_sketchup_win.exe -gui=0 -configFile="config.xml" -quiet=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.
</details>

<details>
<summary>macOS</summary>

1. 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/**.
2. 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**
3. 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.
4. 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**
5. You are then prompted to enter your password.
6. 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.
7. 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.
8. 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.
</details>



## **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. |
| -configFile | Specifies path to an installation configuration file. |
| -gui | Specifies if a Graphic User Interface or a command line one is used during installation:<br>0 – No Graphic User Interface is visible, installation is in command line.<br>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.<br>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.<br>0 – Installation prints all of its output to the console.<br>1 – Installation suppresses the log output. |
| -backup | Specifies whether the installer performs backup on previous installation.<br>0 – Previous installation is not backed up.<br>1 – Previous installation is backed up. |


## <span style="color: #000000">**Configuration File**</span>

---

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

```
<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>
```


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:<br>0 - Does not open the Change Log<br>1 - Opens the Change Log |
| REMOTE_LICENSE | Specifies whether the V-Ray license server runs locally or on another machine:<br>0 - The license server runs locally on the same machine<br>1 - The server is on a different machine in the network |
| REG_LIC_SERVER | Specifies whether to register the V-Ray license server:<br>0 - Does not register the V-Ray license server<br>1 - Registers the V-Ray license server |
| INSTALL_SKETCHUP_2024 | Specifies the installation of V-Ray for SketchUp 2024:<br>0 - Does not install V-Ray for SketchUp<br>1 - Installs V-Ray for SketchUp |
| INSTALL_LICENSE_SERVER | Specifies whether or not to install the V-Ray license server:<br>0 - Does not install the V-Ray license server<br>1 - Install the V-Ray license server |
| INSTALL_SWARM | Specifies whether or not to install V-Ray Swarm:<br>0 - Does not install Swarm<br>1 - Installs Swarm |
| ANONYMIZED_TELEMETRY | Specifies whether to enable [telemetry ](https://docs-chaos.atlassian.net/wiki/spaces/VSKETCHUP/pages/109779885)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:<br>0 - Anonymous telemetry is disabled.<br>1 - Anonymous telemetry is enabled. |
| PERSONALIZED_TELEMETRY | Specifies whether to enable [telemetry ](https://docs-chaos.atlassian.net/wiki/spaces/VSKETCHUP/pages/109779885)for the most used product functionality, parameter values, but also contains personally identifiable information tied to an individual user's license:<br>0 - Personalized telemetry is disabled.<br>1 - Personalized telemetry is enabled. |
| INSTALL_CLOUD | Specifies whether or not to install Chaos Cloud Client App:<br>0 - Does not install Chaos Cloud Client App<br>1 - Installs Chaos Cloud Client App |


## **Notes**

---

- <span style="color: #172b4d">The V-Ray installer should not be run using administrative privileges.</span>