Turbo Client

Turbo Client Installation

The latest Turbo Client may be downloaded from https://turbo.net/download.

Installing Turbo Client for a Single User

To install the Turbo Client using default settings, double-click on the installer. This will configure the client for the current user and place the client components in the %LOCALAPPDATA%\Turbo user directory. Shortcuts will be added to the Start Menu in the Turbo.net folder for quick access to the Turbo.net Preferences. In addition, shortcuts will be added to the Startup folder to automatically start the Turbo Client.

The Turbo Client launches applications from the workspace portal using the turbo:// protocol, so a browser extension is not required for application launches.

Installing Turbo Client for All Users

The Turbo Client can be installed for all users on the machine with the --all-users flag, which will place the client components in the %PROGRAMFILES(x86)%\turbo directory and register the shortcuts for all users on the system.

Note that if users on the machine already have the Turbo Client installed in their user directories, then their single user installs will be overridden by the all user install. Additional updates to the Turbo Client will occur for the all users installation even if the --all-users flag is omitted. If the Turbo Sandbox Manager detects that an instance for all users has been installed while running as single user, it will automatically remove itself to avoid any potential version conflicts.

Turbo Client Unattended Installation

Pass the --silent flag to the client installer to suppress the UI popups that may block unattended installs.

Passing Config Flags to Turbo Client Installer

Pass turbo config flags to the Turbo Client installer to configure the client at install time, such as setting the Turbo Server as the Domain URL and a trusted source.

# Install Turbo Client with a configured Domain URL and trusted source.
> Turbo-Plugin.exe --all-users --silent --domain=https://my.turboserver/ --add-trusted-source=https://my.turboserver/

If you are using the MSI installer, pass the config flags in CMDLINE:

# Install Turbo Client MSI with a configured Domain URL and trusted source.
> msiexec /i Turbo-Plugin.msi cmdline="--domain=https://my.turboserver/ --add-trusted-source=https://my.turboserver/" /qn

Turbo Client Installer Flags

Running the Turbo Client installer with these command line flags can change the install behavior.

Flag

Behavior

--app-server

Installs client and provisions the server to be used as an Application Server in an onpremise streaming pool.

--all-users

Installs the Turbo Client to %PROGRAMFILES(x86)%\turbo so that it is accessible for all users on the machine. This is required for running certain Turbo command for all users (such as `subscribe` or `installi`)

--hide-gui

Disables the Turbo Desktop Preferences shortcut.

--no-auto-start

Stops the per-user SandboxManager process from starting on logon.

--no-auto-update

Disables the check to see if new versions of the client are available.

--no-redirector

Deprecated.

--no-shell-ext

Disables the Turbo Launcher from being visible.

--offline

Forces Turbo commands to run in offline mode, if possible. Any command that requires access to online resources will fail.

--shutdown-period

Specifies the number of minutes that the Turbo Sandbox Manager is idle before shutting down.

--silent

Turbo Client installs without any UI popups.

turbo config flags

Turbo Client installs with the specified turbo config setting. See turbo config for available flags.

Uninstalling the Turbo Client

Uninstalling Turbo Client via Control Panel

You can uninstall the Turbo Client or the TurboLauncher specifically from the Windows Uninstall or change a program screen (previously called Add/Remove Programs).

Uninstalling Turbo Client via the Command Line

To uninstall the Turbo.net Sandbox Manager, you may pass the /uninstall flag to the TurboSandbox.exe in the %LOCALAPPDATA%\turbo[client-version] directory for single user installs or %PROGRAMFILES(x86)%\turbo[client-version] for all user installs.

# Uninstall for single user
C:\> "%LOCALAPPDATA%\Turbo\[client-version]\TurboSandbox.exe" /uninstall /silent

# Uninstall for all users
C:\> "C:\Program Files (x86)\Turbo\[client-version]\TurboSandbox.exe" /uninstall /silent

For unattended or scripted uninstalls, pass the /silent flag in addition.

Note that if the client is installed for all users, you would have to run from an elevated command prompt or the command will fail with insufficient privileges.

TurboSandbox.exe Uninstall Flags

Pass the following flags to the TurboSandbox.exe to uninstall specific components or the whole Turbo Client.

Parameter

Behavior

/uninstall

Uninstalls the Turbo Client. Close all web browsers before uninstalling.

/silent

Used with /uninstall to perform a silent uninstall.

/delete-user-data

Used with /uninstall and /silent to remove user container data during uninstall.

/uninstall-launcher

Uninstalls the TurboLauncher but leaves the rest of the client.

/uninstall-redirector

Uninstalls the TurboRedirector but leaves the rest of the client.