Install Tehama Client on Windows

Latest available Tehama Client version for Windows: 2.4.0

Downloaded from: the Tehama Web UI, current release

Supported Windows versions: Windows 10, Windows 11 and Windows Server 2019

This guide contains the Tehama Client Installation Workflow guide for Windows. Follow the instructions in this guide to install/upgrade a Tehama Client on your Windows device.

Installation workflow

There are three steps to installing the Tehama Client on your Windows device.

• "STEP 1: Download the Client"
• "STEP 2: Uninstall any existing versions of the Client you may already have installed"
• "STEP 3: Install the new version of the Client"

Note: These instructions have been tested on and optimized for the Google Chrome browser.

 download client

1. Log in to the Tehama Web UI.
2. Go to the DESKTOPS page.
3. Click on the INSTALL CLIENT button in the top right of the page. This page provides you with information about the Tehama Client.
4. Click on the download link next to the Windows symbol.
5. Wait for the tehama_pcoip_client.exe file to be downloaded to your Downloads folder.

 uninstall previous client

You can skip this step if your device has never had an earlier version of the Client installed on it.

It is strongly suggested that you first uninstall the current Client (both the Tehama Client and the Teradici PCoIP Client) from your device, then restart your device before installing the new version.

1. Open the Control Panel.
2. Click on "Programs -> Uninstall a program".
3. Right click on "Tehama PCoIP Client version <version>".
4. Select "Uninstall".
5. Click yes on the prompt to allow the application to run.
6. Click yes on the prompt that asks if you are sure you want to completely remove Tehama PCoIP Client and all of its components.
7. Click Ok to dismiss the success dialog.
8. Right click on "Teradici PCoIP Client".
9. Select "Uninstall/Change".
10. Click yes on the prompt to allow the application to run.
11. You may be prompted to select an installer language. If so, select English.
12. Click yes on the prompt that asks if you are sure you want to completely remove Teradici PCoIP Client and all of its components.
13. Click OK when informed that the USB driver files will be completely removed at next reboot.
14. Click OK to dismiss the success dialog.
15. Restart your Windows device.

 install new client

1. Go to your Downloads folder.
2. Double click on tehama_pcoip_client.exe.
3. Click yes on the prompt to allow the application to run.
4. Read through the SOFTWARE LICENSE AGREEMENT.
5. Select "I accept the agreement", if you wish to accept the agreement and click Next.
6. In the dialog that appears, click on "Install" and follow through the instructions that follow - NOTE you will be prompted to restart your browser.
7. Restart your browser.
8. Ensure that your browser does not block the Tehama Client pop-up.
   When connecting to a Desktop, the Tehama Client is launched through a pop-up in your browser. If you attempt to connect to your Desktop using a browser that does not allow the Tehama Client pop-up, then the browser will block the Tehama Client pop-up, and it will not be able to launch. Go into the settings for your chosen browser and make sure that the browser from which you intend to connect to your Desktop allows this pop-up from https://<your-org-subdomain>.tehama.io:443. (Each browser configures pop-up controls differently. Query your browser's help to determine the correct procedure.)
   
   NOTE: In some browsers, it is obvious when a pop-up is being blocked. In others, it is less obvious. For example:
   • In Firefox, a banner will appear at the top of the page stating that Firefox prevented the site from opening the pop-up. Click on the "Options" button on the banner to view your pop-up options.
   • In Google Chrome, the indication that a pop-up is being blocked is a small icon with a red X that appears in the browser's address bar. Click on that icon to allow pop-ups.
9. Log in to Tehama Web UI in the restarted browser, if you are not already logged in.
10. Navigate to the DESKTOPS page. (From the TEHAMA CLIENT page, just click CLOSE X.)
11. Locate your Tehama Desktop in the list of desktops.
12. Connect to your desktop with one-click by clicking on the CONNECT button.
13. A prompt will appear asking you to allow Tehama to open an application: "Open Microsoft Windows Based Script Host".
14. Click on "Allow".
    
    Now the Tehama Client is ready for use and your Desktop should launch.