---
title: "Installer Program Options"
canonical: "https://documentation.chaos.com/space/ESKETCHUP/127834012/Installer%20Program%20Options"
format: markdown
---
This page provides information on how to silently install Enscape.

## **Overview**

---

A silent installation allows you to complete Enscape installation without user input during the process using a predefined set of options.


By using the Chaos installer for automatic installation with the -auto argument, you accept the <u>[Chaos End User License Agreement](https://static.chaos.com/documents/assets/000/000/508/original/Chaos_EULA_20250517.pdf?1747475254)</u> and the <u>[Chaos Global Consumer Privacy Policy](https://www.chaos.com/privacy)</u>.


## **Windows**

---

In order for a System Administrator to install Enscape on multiple machines, a **config.xml** file containing all settings must be first prepared, that will later be used when deploying Enscape on users’ machines. 

To learn more about deploying your license to multiple machines, go to [this page](https://docs-chaos.atlassian.net/wiki/spaces/LIC5/pages/124494252).

To set up a silent installation, you need to perform two steps: creating an **.xml configuration file (that stores the installation parameters) **and running the installer.

Run the installation file with the following arguments:


```
Enscape-4.1.0.exe -gui=0
```


Follow the instructions of the installation and set up the installation the way you want to have it on all machines. Alternatively, if you are creating a basic installation, you can add the **-auto** tag to automate the installation with all the default options. This will create a file named **config.xml** in the folder of the installation executable file. Save this **config.xml** file as you will need it to install Enscape on other machines.

To install Enscape on users’ machines, run the installation file from an Administrator command prompt with the following arguments:


```
Enscape-4.1.0.exe -gui=0 -configFile=.\config.xml -quiet=1
```


The example above assumes that **config.xml** is located in the current working directory, that is, the directory the command is executed from. If this is not the case, the correct path (relative or absolute) to **config.xml** should be specified instead.

Also, make sure that if you are using double quotes to surround paths containing spaces, you are using the standard vertical [Quotation mark character](https://www.compart.com/en/unicode/U+0022)  and **not** some of the other left/right double quotation mark characters. The path to **config.xml** must be a valid relative or absolute path. Web URLs, i.e. paths starting with **http** are not supported for specifying the **config.xml** location.

The **-quiet=1** argument will cause the installer to read the variable values from the **config.xml** file and do the installation without user input. If you do not specify the **-quiet=1** option, the installer will ask for a confirmation of each variable before proceeding.

### **Silently Uninstall Enscape**

---

To silently uninstall **Enscape 4.0 and higher**, run the installation file from an Administrator command prompt with the following arguments:


```
Enscape-4.0.0.exe -gui=0 -auto -uninstallApp="Enscape" -uninstall="C:\Program Files\Enscape\uninstall\install.log"
```


The path to install.log may vary depending on the location where Enscape was installed. Change *“Enscape-4.0.0.exe”* to the version you want to uninstall.

To silently uninstall **Enscape 3.5 and lower**, use the **msiexec **command from an Administrator command prompt with the following arguments:


```
start /w msiexec.exe /x "C:\Enscape-3.5.6+204048.msi" /quiet /L* "C:\Enscape_uninstall.log"
```


Change the path and name for the *.msi and *.log according to your installed version and needs.


### **Configuration File**

---

The **config.xml** file contains configuration information for the installation's settings. Below are examples of such a config file:

#### **Cloud Licensing**

```powershell
<DefValues>
 <Value Name="LOCALE" DataType="value">en-US</Value>
 <Value Name="STDROOT" DataType="value">C:\Program Files\Enscape</Value>
 <Value Name="INSTALL_ARCHICAD" DataType="value">1</Value>
 <Value Name="INSTALL_REVIT" DataType="value">1</Value>
 <Value Name="INSTALL_RHINO" DataType="value">1</Value>
 <Value Name="INSTALL_SKETCHUP" DataType="value">1</Value>
 <Value Name="INSTALL_VECTORWORKS" DataType="value">1</Value>
 <Value Name="ANONYMIZED_TELEMETRY" DataType="value">0</Value>
 <Value Name="PERSONALIZED_TELEMETRY" DataType="value">0</Value>
 <Value Name="LICENSE_TYPE" DataType="value">0</Value>
 <Value Name="REMOTE_LICENSE" DataType="value">0</Value>
 <LicServer>
  <Type>0</Type>
  <Host>localhost</Host>
  <Port>30304</Port>
  <Host1></Host1>
  <Port1>30304</Port1>
 </LicServer>
</DefValues>
```

#### **Local License Server**

```powershell
<DefValues>
 <Value Name="LOCALE" DataType="value">en-US</Value>
 <Value Name="STDROOT" DataType="value">C:\Program Files\Enscape</Value>
 <Value Name="INSTALL_ARCHICAD" DataType="value">1</Value>
 <Value Name="INSTALL_REVIT" DataType="value">1</Value>
 <Value Name="INSTALL_RHINO" DataType="value">1</Value>
 <Value Name="INSTALL_SKETCHUP" DataType="value">1</Value>
 <Value Name="INSTALL_VECTORWORKS" DataType="value">1</Value>
 <Value Name="ANONYMIZED_TELEMETRY" DataType="value">0</Value>
 <Value Name="PERSONALIZED_TELEMETRY" DataType="value">0</Value>
 <Value Name="LICENSE_TYPE" DataType="value">1</Value>
 <Value Name="REMOTE_LICENSE" DataType="value">0</Value>
 <LicServer>
  <Type>1</Type>
  <Host>localhost</Host>
  <Port>30304</Port>
  <Host1></Host1>
  <Port1>30304</Port1>
  <Host2></Host2>
  <Port2>0</Port2>
 </LicServer>
</DefValues>
```

#### **Remote License Server**

```powershell
<DefValues>
 <Value Name="LOCALE" DataType="value">en-US</Value>
 <Value Name="STDROOT" DataType="value">C:\Program Files\Enscape</Value>
 <Value Name="INSTALL_ARCHICAD" DataType="value">1</Value>
 <Value Name="INSTALL_REVIT" DataType="value">1</Value>
 <Value Name="INSTALL_RHINO" DataType="value">1</Value>
 <Value Name="INSTALL_SKETCHUP" DataType="value">1</Value>
 <Value Name="INSTALL_VECTORWORKS" DataType="value">1</Value>
 <Value Name="ANONYMIZED_TELEMETRY" DataType="value">0</Value>
 <Value Name="PERSONALIZED_TELEMETRY" DataType="value">0</Value>
 <Value Name="LICENSE_TYPE" DataType="value">1</Value>
 <Value Name="REMOTE_LICENSE" DataType="value">1</Value>
 <LicServer>
  <Type>1</Type>
  <Host>10.0.0.24</Host>
  <Port>30304</Port>
  <Host1></Host1>
  <Port1>30304</Port1>
  <Host2></Host2>
  <Port2>30304</Port2>
 </LicServer>
</DefValues>
```


### **Description of the Variables for the Installer**


|  |  |  |
| --- | --- | --- |
| **VARIABLE** | ** VALUE ** | **DESCRIPTION** |
| LOCALE | de | Deutsch |
|  | en-US | English (United States) |
|  | es | Español |
|  | fr | Français |
|  | it | Italiano |
|  | nl | Nederlands |
|  | pl | Polski |
|  | pt-BR | Português (Brasil) |
|  | zh-Hans | 中文(简体) |
|  | ja | 日本語 |
| STDROOT | path | Specifies the installation location for Enscape. The default for All Users installation is C:\Program Files\Enscape on Windows and /Library/Chaos/Enscape on macOS. |
| LICENSE_TYPE | 0/1 | Specifies the Licensing mode:  
0 - Cloud Licensing  
1 - License Server |
| INSTALL_ARCHICAD | 0/1 | Specifies whether Enscape should be installed for Archicad. |
| INSTALL_REVIT | 0/1 | Specifies whether Enscape should be installed for Revit. |
| INSTALL_RHINO | 0/1 | Specifies whether Enscape should be installed for Rhino. |
| INSTALL_SKETCHUP | 0/1 | Specifies whether Enscape should be installed for SketchUp. |
| INSTALL_VECTORWORKS | 0/1 | Specifies whether Enscape should be installed for Vectorworks. |
| REMOTE_LICENSE | 0/1 | Specifies Local (0) or Remote (1) License Server. If Remote License Server is specified, its address must be in the LicServer section. |
| ANONYMIZED_TELEMETRY | 0/1 | Specifies whether Anonymized Telemetry is enabled. |
| PERSONALIZED_TELEMETRY | 0/1 | Specifies whether Personalized Telemetry is enabled. If ANONYMIZED_TELEMETRY is 0, this value will be ignored. |
| LicServer | 0/1 | Specifies Host-Port entries for the License Server. Enter the address of the Remote License server here if REMOTE_LICENSE is 1. |

> Macro (ui-text-box)
> 
> Please, be aware that the **LOCALE**, **ANONYMIZED_TELEMETRY** and **PERSONALIZED_TELEMETRY** values specified during installation are the **default** values for new Enscape installations. If users change their preferences later through the Enscape UI inside the CAD, the users' preferences will be serialized in their personal **settings.json** file and they will not be overwritten by a subsequent Enscape installation. Personal user preferences always take precedence over the **default** values set by the Installer.
> 
> The **settings.json** file is located in ***%USERPROFILE%\Documents\Enscape\Settings**** *on Windows and in ***~/Documents/Enscape/Settings*** on Mac.


## **macOS**

---

### **Install Enscape on Other Machines**

To install Enscape on multiple machines, prepare a **config.xml** file with the following content and adjust it as needed.


```powershell
<DefValues>
<Value Name="LOCALE" DataType="value">en-US</Value>
<Value Name="STDROOT" DataType="value">/Library/Chaos/Enscape</Value>
<Value Name="INSTALL_ARCHICAD" DataType="value">1</Value>
<Value Name="INSTALL_RHINO" DataType="value">1</Value>
<Value Name="INSTALL_SKETCHUP" DataType="value">1</Value>
<Value Name="INSTALL_VECTORWORKS" DataType="value">1</Value>
<Value Name="REMOTE_LICENSE" DataType="value">0</Value>
<Value Name="ANONYMIZED_TELEMETRY" DataType="value">1</Value>
<Value Name="PERSONALIZED_TELEMETRY" DataType="value">0</Value>
<LicServer>
<Host>localhost</Host>
<Port>30304</Port>
<Host1></Host1>
<Port1>30304</Port1>
<Host2></Host2>
<Port2>30304</Port2>
<User></User>
</LicServer>
</DefValues>
```


Mount the installation **.dmg** file to a directory of your choice from the command prompt with the following commands:

```
hdiutil attach Enscape-4.1.0.dmg -mountpoint ./enscape_mountpoint
```


Run the installation file from the command prompt with the following arguments:

```
./enscape_mountpoint/Enscape\ Installer.app/Contents/MacOS/Enscape.Installer -gui=0 -configFile=./config.xml -quiet=1
```


The example above assumes that **config.xml** is located in the current working directory, that is, the directory the command is executed from. If this is not the case, the correct path (relative or absolute) to **config.xml** should be specified instead. Also, make sure that if you are using double quotes to surround paths containing spaces, you are using the standard vertical [Quotation mark character](https://www.compart.com/en/unicode/U+0022) and **not** some of the other left/right double quotation mark characters. The path to **config.xml** must be a valid relative or absolute path. Web URLs, i.e. paths starting with **http** are not supported for specifying the **config.xml** location.

The **-quiet=1** argument will cause the installer to read the variable values from the **config.xml** file and do the installation without user input. If you do not specify the **-quiet=1** option, the installer will ask for a confirmation of each variable before proceeding.


### **Silently Uninstall Enscape**

---

To silently uninstall Enscape, run the installation file from the command prompt with the following arguments:

```
./enscape_mountpoint/Enscape\ Installer.app/Contents/MacOS/Enscape.Installer -gui=0 -auto -uninstallApp="Enscape" -log="/Library/Chaos/Enscape/uninstall/install.log"
```


Once you are done with the installation/uninstallation, unmount the drive:

```
hdiutil detach ./enscape_mountpoint
```


### **Description of Variables for the Installer**


|  |  |  |
| --- | --- | --- |
| **VARIABLE** | ** VALUE ** | **DESCRIPTION** |
| LOCALE | de | Deutsch |
|  | en-US | English (United States) |
|  | es | Español |
|  | fr | Français |
|  | it | Italiano |
|  | nl | Nederlands |
|  | pl | Polski |
|  | pt-BR | Português (Brasil) |
|  | zh-Hans | 中文(简体) |
|  | ja | 日本語 |
| STDROOT | path | Specifies the installation location for Enscape. The default for All Users installation is C:\Program Files\Enscape on Windows and /Library/Chaos/Enscape on macOS. |
| LICENSE_TYPE | 0/1 | Specifies the Licensing mode:  
0 - Cloud Licensing  
1 - License Server |
| INSTALL_ARCHICAD | 0/1 | Specifies whether Enscape should be installed for Archicad. |
| INSTALL_RHINO | 0/1 | Specifies whether Enscape should be installed for Rhino. |
| INSTALL_SKETCHUP | 0/1 | Specifies whether Enscape should be installed for SketchUp. |
| INSTALL_VECTORWORKS | 0/1 | Specifies whether Enscape should be installed for Vectorworks. |
| REMOTE_LICENSE | 0/1 | Specifies Local (0) or Remote (1) License Server. If Remote License Server is specified, its address must be in the LicServer section. |
| ANONYMIZED_TELEMETRY | 0/1 | Specifies whether Anonymized Telemetry is enabled. |
| PERSONALIZED_TELEMETRY | 0/1 | Specifies whether Personalized Telemetry is enabled. If ANONYMIZED_TELEMETRY is 0, this value will be ignored. |
| LicServer | 0/1 | Specifies Host-Port entries for the License Server. Enter the address of the Remote License server here if REMOTE_LICENSE is 1. |

> Macro (ui-text-box)
> 
> Please, be aware that the **LOCALE**, **ANONYMIZED_TELEMETRY** and **PERSONALIZED_TELEMETRY** values specified during installation are the **default** values for new Enscape installations. If users change their preferences later through the Enscape UI inside the CAD, the users' preferences will be serialized in their personal **settings.json** file and they will not be overwritten by a subsequent Enscape installation. Personal user preferences always take precedence over the **default** values set by the Installer.
> 
> The **settings.json** file is located in ***%USERPROFILE%\Documents\Enscape\Settings**** *on Windows and in ***~/Documents/Enscape/Settings*** on Mac.