Turbo Client

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 TurboLauncher and TurboShell. In addition, shortcuts will be added to the Startup folder to automatically start the Turbo Client.

The Turbo.net Extension is required when using the client with the Chrome browser. It may be found in the Chrome Web Store at [https://chrome.google.com/webstore/detail/turbonet-extension/ldibmiofagdkgiphkcokpooepankmacl] (https://chrome.google.com/webstore/detail/turbonet-extension/ldibmiofagdkgiphkcokpooepankmacl).

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 overriden 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.

For all user installs in environments using the Chrome browser, the Turbo.net Extension may be enabled via group policy. See the [Enable the Turbo.net Extension for All Chrome Users] (https://blog.turbo.net/deploying-turbo-browser-url-redirection-via-group-policy/) section on the Turbo.net Blog.

Turbo Client Unattended Installation

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

Turbo Client Installer Flags

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

Flag

Behavior

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

--no-auto-start

Stops the Turbo Sandbox Manager from starting in the background when logging into your machine. If this flag is used, other components or your web browser will have to start the process on demand and may reduce performance.

--server

Sets the default server for Client component login. This is used in environments with Turbo Server.

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

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 Turbo-Sandbox.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]\Turbo-Sandbox.exe" /uninstall /silent

# Uninstall for all users
C:\> "C:\Program Files (x86)\Turbo\[client-version]\Turbo-Sandbox.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.

Turbo-Sandbox.exe Uninstall Flags

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

Parameter

Behavior

/uninstall

Uninstalls the Turbo Plugin. 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.

### Edge Browser Extension

Microsoft Edge is the latest browser for the Windows 10 platform. In the Windows 10 Anniversary Update (build 1607), a browser extension feature was added to allow custom functionality to be built by third parties.

Edge support for third party extensions is very new and limited. Therefore, multiple manual steps are required to enable the Turbo Edge extension. This process should be simplified as Edge extension support matures.

Follow the steps below to enable the Turbo.net extension.

Step 1: Ensure that you have the latest Turbo.net Client installed.

Step 2: Enable Edge communications to localhost via the command below:

# Run this command in an elevated, administrator command prompt
> CheckNetIsolation LoopbackExempt -a -n=Microsoft.MicrosoftEdge_8wekyb3d8bbwe

All applications which are built with Windows 10 “Modern UI” architecture have disabled access to the local machine network. The Edge browser is built on this architecture so access to localhost is disabled. The Turbo.net browser extension requires communication with local services provided by the Turbo client runtime in order to allow coordination with the Turbo Sandbox Manager.

Step 3: Enable Edge browser extensions by typing about:flags into the browser’s location bar and checking the Enable extension developer features checkbox.
Once enabled, you’ll need to restart the browser.

Step 4: Load the Turbo.net extension by clicking on the Edge options menu dropdown and selecting Extensions.

This will show the Extensions menu.

Step 5: Click on Load Extensions and select the path to the Turbo.net Edge extension in the client install directory, which may be at one of the following locations depending on your environment:

  • c:\users[user]\appdata\local\turbo[version]\edge
  • c:\program files\turbo[version]\edge
  • c:\program files (x86)\turbo[version]\edge

Step 6: Once loaded, the Turbo.net Extension will show up in the list of extensions that you have enabled for Edge.
You will again need to restart your browser in order for the extension to be enabled.

Step 7: Edge automatically disables extensions for the first 10-seconds when it is started. After that time a banner prompt will be shown on the bottom asking to turn them on. Click the Turn on anyway button to enable them.
Currently this step is required every time you start the Edge browser.

At this point you’ll be able to use Turbo.net functionality!

Questions? Projects? Talk to us.