First Steps

This page covers the installation, setup, and removal of Enscape.

Overview

Preliminary steps for best results:

1. Close the CAD software.
2. Make sure the user account you are using has the right to install software on the operating system.
3. Open and run the Enscape.exe (Windows) / Enscape.dmg (MacOS) installer from the download location.

For deployment of Enscape to multiple machines, you should also refer to the Installer Program Options.

The installer prompts for admin credentials at the start of installation, even when already logged in as an admin.

Running the Installer

Welcome to Enscape setup wizard

Read and accept the End User License Agreement and the Global Consumer Privacy Policy.

Then, click the Next button.

Language

Select a language from the dropdown list. English is selected by default.

Click Next to continue.

Cloud Licensing

When installing for the first time, Enscape will use Cloud Licensing by default.

Click Install to continue with Cloud Licensing. If you need to connect to a network License Server, click Use License Server.

Chaos products use two licensing models: Cloud Licensing and the License Server. Cloud Licensing offers maximum flexibility, allowing users to sign in with their Chaos Account and use products from any location with an Internet connection. The License Server allows to set up centralized network setups and requires you to be on the same local network or connect through a VPN.

Chaos Telemetry

Enscape installation is successful.

Participate in the improvement decisions for future versions of V-Ray. No intellectual property is violated when agreeing to participate in the feedback program. Chaos does not gather scenes, assets, materials, etc. This preference can be changed at any time from V-Ray Render Settings > Settings > About V-Ray > Feedback program settings. For more information, see the Chaos Telemetry page.

Anonymized Telemetry – Includes 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.

Personalized Telemetry – Includes the most used product functionality and parameter values, but also contains personally identifiable information tied to an individual user's license. This helps Chaos tailor and optimize the product for better personal use.

Advanced installation settings

Change destination folder

Clicking the Advanced button leads to the Change destination folder screen.

Click the three dots to select a new installation location or click Next to proceed with the default location setup.

Licensing

In this step, you can specify whether V-Ray will use Cloud Licensing - a direct connection to the Chaos Licensing Service, or the Chaos License Server.

Cloud Licensing allows you to use your product from any location with an Internet connection by signing in with your Chaos Account.

License Server

The License Server is an additional application that can be used to set up centralized network licensing and / or use offline licenses. The License Server can be installed locally on the same device as the product, or remotely on a centrally accessible network machine within your local network.

• Local – This option installs the License Server on your machine. For a walkthrough, see the Chaos License Quick Start Guide.
• Remote – This option allows you to configure your Chaos product for floating licenses in a local network. Fill in the IP address of the Chaos License Server in your network in the Primary License Server field. Please leave the port 30304 unchanged. For more details on this setup, see the License Server Deployment page.

Host Application

After clicking Install, specify whether to install the plug-in for one specific CAD, multiple CADs, or all CADs.

Installation Error Messages

If the CAD is open when installing, repairing, changing, or removing Enscape, a warning message appears identifying which CAD is blocking the installation process. Close all CAD applications before continuing with the installation.

Once installation is complete, restart the operating system to apply the changes.

Remove Enscape

For Windows

To remove Enscape, open the Windows Add or Remove Programs feature. Find Enscape in the list manually or through the search bar. Click the application and select Uninstall.

For macOS

To uninstall Enscape from Mac, go to the install directory (e.g., /Library/Chaos/Enscape/uninstall) and open the Uninstaller.

A dialog appears, prompting the selection of the program to uninstall. Select Enscape and click Uninstall.

Running the Uninstaller

The Enscape Uninstaller window opens. Click Uninstall to continue.

In the next window, you will get a confirmation that Enscape has been successfully removed from your machine.

Click Done to close the window.

To uninstall Enscape from Mac using Terminal:

1. If the installer is not present on the machine, download the current Mac installer to the Downloads folder.
2. Go to Applications > Utilities and open the Terminal application.
3. Copy and paste the following into the Terminal window:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">cd Downloads</span></code>

Press Enter to execute.

1. Copy and paste the following into the Terminal window, followed by Enter to execute:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">hdiutil attach Enscape-4.1.0.2288.dmg -mountpoint ./enscape_mountpoint</span></code>

A new image will now appear on the Desktop that you can disregard at this time.

In case your dmg has a different name or a different version, please replace it in the command line above.

1. Copy and paste the following into the Terminal window, followed by Enter to execute:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">./enscape_mountpoint/Enscape\ Installer.app/Contents/MacOS/Enscape.Installer -gui=0 -auto -uninstallApp="Enscape" -log="/Library/Chaos/Enscape/uninstall/install.log"</span></code>

1. Terminal prompts for the administrator password. The cursor/indicator does not move while the password is entered. Press Enter when complete.
2. The Mac executes several steps, which takes a short while. Once finished, the line "Automatic uninstallation was successful!" appears in the Terminal window.
3. As a last step, copy and paste the following into the Terminal window, followed by Enter to execute:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">hdiutil detach ./enscape_mountpoint</span></code>

This removes the volume from the Desktop. Enscape version 4.0 is now uninstalled.