Install Tehama Client on Mac
Latest available Tehama Client version for Mac: 2.4.0
Downloaded from: the Tehama Web UI, current release
Supported macOS versions: Mojave to Monterey
This guide contains two parts:
- "Installation workflow": Go here to install/upgrade a Tehama Client on your Mac device.
- "Post installation issues/enhancements": Go here to address post installation issues and enhanced Tehama Client configurations.
Installation workflow
There are four steps to installing the Tehama Client on your Mac 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"
- "STEP 4: Configure permissions for keyboard and other peripherals"
Note: These instructions have been tested on and optimized for the Google Chrome browser.
download client
- Log in to the Tehama Web UI.
- Go to the DESKTOPS page.
- Click on the INSTALL CLIENT button in the top right of the page. This page provides you with information about the Tehama Client.
- Click on the download link next to the Apple symbol.
- Wait for the tehama_pcoip_client.dmg 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.
- Remove ‘Tehama’ and ‘PCoIPClient’ from your Applications folder (move them to Trash).
- Make sure ‘applet’, a residual client application, is removed from your device's Accessibility settings, as follows:
- Open the Security & Privacy modal, from System Preferences.
- Click on the 'Privacy' tab.
- Select 'Accessibility' from the sidebar menu. This shows the list of apps that are allowed to control your computer.
- Locate 'applet' in the list.
- Click the lock the make changes (you will need to provide authorization).
- Place a checkmark in the checkbox next 'applet'.
- Click on minus sign to remove 'applet'.
- Click the lock to prevent any more changes. (Only need to do this after the last one.)
- Restart your device.
install new client
- Go to your Downloads folder.
- Double-click on tehama_pcoip_client.dmg.
- Read through the SOFTWARE LICENSE AGREEMENT.
- Click on "Agree", if you wish to accept the agreement and proceed.
- Observe the dialog with text "Drag and drop both apps into Applications folder to install" appears.
- Left click and hold on the "Tehama.app" symbol, drag it over the "Applications" symbol and release.
- Left click and hold on the "PCoIPClient.app" symbol, drag it over the "Applications" symbol and release.
- Dismiss the dialog.
The Client is installed on your device, but still needs to have its permissions configured. This is done the during the first time you attempt to connect to a Tehama Desktop with your newly installed client. Continue on to STEP 4 to do that now.
configure client permissions
This step configures the Client permissions needed to ensure that peripherals, accessories like your keyboard and mouse, function properly with your Tehama Desktop.
If you intend to use an extended keyboard with your Tehama Desktop, you may also need to configure additional Client permissions by following the instructions in the section "The number pad from my extended keyboard is not working inside the Tehama Desktop" after you have finished this step.
- Open your browser, if it is not already open.
- Log in to the Tehama Web UI, if you are not already logged in.
- Navigate to the DESKTOPS page. (From the TEHAMA CLIENT page, just click CLOSE X.)
- Locate your Tehama Desktop in the list of desktops.
- Connect to your desktop with one-click by clicking on the CONNECT button.
- After your desktop has finished preparing, a message will appear, asking you if you want to "Open Tehama.app?".
- Click on "Open Tehama.app".
- You should see a prompt with the following message: '"applet" would like to control this computer using accessibility features. Grant access to this application in Security & Privacy preferences, located in System Preferences.'
If you do not see this prompt, try following the alternate method for configuring Client permissions in section "My keyboard is not working inside the Tehama Desktop".
At this point:- Click Open System Preferences. The Security & Privacy modal will appear, open to the 'Accessibility' list of apps. You should see the 'applet' application in the Accessibility list.
- Place a checkmark in the checkbox beside 'applet'.
Now the Client is configured. NOTE: This configuration only takes effect the next time you connect to your Tehama Desktop.
- Restart your Tehama Desktop. (Close your current session and re-connect to a new session.)
Post installation issues/enhancements
After you have installed the Tehama Client, you should be able to launch and use your Tehama Desktop.
This section describes how to solve issues some users may experience with the Tehama Client on Mac.
This section also contains Tehama Client configuration enhancements, like how to remap the behaviour of Command+C/V to be the same in your Mac device and on your Tehama Windows Desktop.
keyboard not working
If you are experiencing problems with your keyboard when in a Tehama Desktop session on your Mac device, the most likely explanation is that the Client permissions on your device are not configured appropriately. Possibly the usual method of configuring Client permissions may not have worked for you. Try following these alternate instructions to help you resolve the issue.
- Uninstall your Client from your device. (Follow the instructions above in section "Uninstall previously installed Clients".)
- Then re-install the Client on your device. (Follow the instructions above to "Install the new version of the Client".)
- Make sure your device's 'Accessibility' list does not contain any residual Tehama Client-related applications. You should not see 'applet', 'Tehama', or 'PCoIPClient' on the list.
- Open the Security & Privacy modal, from System Preferences.
- Click on the 'Privacy' tab.
- Select 'Accessibility' from the sidebar menu. This shows the list of apps that are allowed to control your computer.
- Look for 'applet', 'Tehama' and 'PCoIPClient'.
- For each of these apps that you find,
- Click the lock the make changes (you will need to provide authorization). (Only need to do before the first one.)
- Place a checkmark in the checkbox next 'applet'.
- Click on minus sign to remove 'applet'.
- Click the lock to prevent any more changes. (Only need to do this after the last one.)
- Go to your Applications folder, right-click on ‘Tehama’, and ‘Show Package Contents’.
- The next step depends on your device's macOS version:
- If your macOS version is Big Sur.
- Find ‘applet’ from the path "Contents -> MacOS -> applet", and drag this ‘applet’ to Accessibility.
- Find ‘applet’ from the path "Contents -> MacOS -> applet", and drag this ‘applet’ to Accessibility.
- If your macOS version is Catalina or lower.
- Find ‘Tehama’ from the path "Contents -> MacOS -> Tehama", and drag this ‘Tehama’ to Accessibility.
- Find ‘Tehama’ from the path "Contents -> MacOS -> Tehama", and drag this ‘Tehama’ to Accessibility.
- If your macOS version is Big Sur.
- Normally the ‘applet’ or ‘Tehama’ from the previous step should be checked, if not, check the checkbox.
- Click the lock (in the Security & Privacy modal) to prevent any more changes.
- Connect to your Tehama Desktop to try it out. (If you have an open Desktop session, close it and reconnect.)
Your keyboard should be working at this point.
extended number pad not working
The Tehama Client allows you to use your peripheral devices with it, so you can get the most out of your Tehama desktop.
An important peripheral device is an extended keyboard, a keyboard with a number pad. A small number of Tehama Desktop users may need to run through the following instructions to configure additional Client permissions in order to use this peripheral with the Client on their Mac devices.
It is assumed that you have already installed the Client, following the instructions in the Installation Workflow.
- Add PCoIPClient into your Accessibility list, and make sure everything is checked on that list.
- Open the Security & Privacy modal, from System Preferences.
- Click on the 'Privacy' tab.
- Select 'Accessibility' from the sidebar menu. This shows the list of apps that are allowed to control your computer.
- Click the lock to make changes (you will need to provide authorization).
- Click on the plus sign to add a new application to the list. A file system browser modal will appear.
- Navigate in the Finder app to the Applications folder.
- Select the PCoIPClient application.
- Click the Open button. The PCoIPClient application will now be in the Accessibility list.
- Place a checkmark in the checkbox beside PCoIPClient, if it is not already checked.
- Click the lock to prevent any more changes.
- Connect to your Tehama Desktop to try it out. (If you have an open Desktop session, close it and reconnect.)
- Try clicking the clear key once when you are inside a Tehama Windows Desktop, to verify that you can now use the extended keyboard.
Mac control vs command in Tehama Windows Desktop
By default, the keyboard is mapped to align with the operating system you are using. For example, if you use Tehama Windows Desktops from a MacBook, due to the difference between Windows and macOS on their control/command keys, your experience will be as follows:
- When you are inside the Tehama Windows desktop, Control+C/V is used for copy/paste
- When you are on your local MacBook, Command+C/V is used for copy/paste
If you would like to remap this experience to use Command+C/V for both macOS and Tehama Windows Desktop, please do the following:
- Open Terminal on macOS.
- Run the following command line one by one in Terminal:
The last line ensure the 'command' key maps to the 'Ctrl' key on your Tehama Windows desktop.defaults write "com.teradici.Teradici PCoIP Client" mac_capture_all_keys 0
defaults write "com.teradici.Teradici PCoIP Client" mac_system_shortcut_capture 0
defaults write "com.teradici.Teradici PCoIP Client" remap_cmd_to_ctrl 1
- Connect to your Tehama Desktop to try it out. (If you have an open Desktop session, close it and reconnect.)