# TeamViewer: macOS Client Setup

## What

FileWave's TeamViewer integration requires endpoint prerequisites on each supported platform. Majority of these have been left untouched, but may be altered, allowing slightly more work (if desired) but much greater control.

## When/Why

TeamViewer is used to remotely control your clients, providing access to a device for troubleshooting or assisting a user. TeamViewer for macOS differs from other OSs since it requires a few privacy permissions before allowing TeamViewer to be installed.

## How

Prerequisites for macOS client devices must be met in order for TeamViewer to work seamlessly:

- Server and Clients have to be FileWave 14.7+
- [General TeamViewer Prerequisites](https://kb.filewave.com/books/teamviewer/page/teamviewer-general-pre-requisites) are met, ensuring that clients are set to allow remote control
- [TCC Profile for TeamViewer Host - Accessibility and Full Admin Access](#bkmrk-tcc-profile-for-team)
- [TeamViewer Host Fileset](#bkmrk-teamviewer-host-file)

The below describes installing the TeamViewer Host application. The full TeamViewer application is only necessary for computers wanting to remote into other computers. The Host application is only allowed to accept connections and not initiate them; highly recommended.

(During an attempt to prompt a device for control, users will be prompted to either install or launch a local copy of Teamviewer. Only the TeamViewer Host version can be launched if pre-installed.)

### FileWave Client (14.7+)

<p class="callout warning">Remember to always use the client updater Fileset to update FileWave clients. Do **NOT** push the FileWave client PKG to upgrade macOS clients.</p>

The most recent FileWave client is always included on the FileWave download pages: [Downloads](https://kb.filewave.com/books/downloads "Downloads")

### TCC Profile for TeamViewer Host - Accessibility and Full Admin Access

<p class="callout info">Both profiles enable 2 of the 3 permissions TeamViewer Host requires. The 3rd, Screen Recording, is a privacy setting that can not be allowed by anyone other than a local user. Standard Users do not have permissions to allow Screen Recording by default. This option to allow a non-Admin to enable Screen Sharing is available in one of the provided Profiles.</p>

<p class="callout warning">Screen Sharing is a service deemed by Apple as user privacy. Hence, users must locally enable Screen Sharing on macOS.</p>

<p class="callout success">Once allowed, if left enabled, subsequent TeamViewer sessions to that device my be actioned, without user prompting.</p>

Both Profiles have the following settings:

[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-04/scaled-1680-/Wr6Ov94aWjqAGa9g-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-04/Wr6Ov94aWjqAGa9g-image.png)

However, one of them allows Screen Recording to be enabled by a non-Admin user:

[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-04/scaled-1680-/mCFamzRWYr2MtnXy-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-04/mCFamzRWYr2MtnXy-image.png)

Each profile contains two payloads: Privacy Settings &amp; Custom Settings

#### Privacy Settings

Permissions to allow TeamViewer access rights.

<table border="1" id="bkmrk-tcc-profile-for-team-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>**<u>TCC Profile for TeamViewer Host</u>:**

- **[TeamViewerHost15.mobileconfig](https://kb.filewave.com/attachments/435)**

**<u>TCC Profile for TeamViewer Host with</u><u> Standard User Screen Recording Allowance 11+</u>:**

- **[TeamViewerHost15AllowUser.mobileconfig](https://kb.filewave.com/attachments/434)**

</td></tr></tbody></table>

### TeamViewer Host Fileset

The included Filesets are examples which utilise a settings file set to instal the software silently.

Choose an embedded TeamViewer Fileset:

<table border="1" id="bkmrk-note-that-you-only-n" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>**Note: if more than one of the below is shown, only one is required, but older version might be offered.**

[TeamViewer Host Install macOS 15.63.4.fileset.zip](https://kb.filewave.com/attachments/436)

</td></tr></tbody></table>

Latest version can be downloaded from TeamViewer directly, however, the public downloadable DMG has an application that instals the software and does not allow for the configuration presented at the time of installation; upgrades should occur automatically as indicated below

- [macOS TeamViewer Host](https://download.teamviewer.com/download/TeamViewerHost.dmg)

#### Fileset Contents:

[![image.png](https://kb.filewave.com/uploads/images/gallery/2025-03/scaled-1680-/2XlZBYLDFNuyrzw2-image.png)](https://kb.filewave.com/uploads/images/gallery/2025-03/2XlZBYLDFNuyrzw2-image.png)

##### Installer and Installer Options:

The choices.xml file is configured to instal the .pkg silently. However, the user will be prompted with notifications, since Apple allow users to choose if apps are allowed to control the screen or not.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-09/scaled-1680-/VmJ52iXvv3u9Butt-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-09/VmJ52iXvv3u9Butt-image.png)

##### Requirement Script:

Where software is already installed and services are active, Privacy Settings Profiles installed subsequently require the service of that software to be restarted. This Fileset example includes a Requirement Script that checks for profile installation before activating TeamViewer, preventing the need to restart the TeamViewer Host service.

The 'check\_tv\_profile.sh' script is designed to recognise one of the two provided Profiles and, once installed, allow activation of the Fileset. If Profiles with a different Profile ID are used instead of those supplied, the script settings will require alteration.

- Double click the Fileset
- Select the 'check\_tv\_profile.sh' (located in a numbered subfolder in /var/scripts/)
- Choose Get Info &gt; Executable view

The Launch Arguments show the two possible Payload IDs. Add in the correct Fileset Profile ID if not using the provided ones.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-04/scaled-1680-/Zg9Ly21aSi8Abtnz-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-04/Zg9Ly21aSi8Abtnz-image.png)

<p class="callout info">The two profiles may be uploaded simultaneously. The Fileset Requirement Script is able to identify either profile.</p>

##### Activation Script:

The script in this case is installing the PKG. Note the script allows the specifying of the 'choices.xml' file when ran.

```
#!/bin/zsh
installer -applyChoiceChangesXML /usr/local/etc/TeamViewer/choices.xml -pkg "/usr/local/etc/TeamViewer/Install TeamViewerHost.pkg" -target /
exit 0
```

##### Postflight

This script provides examples of configuring the TeamViewer Host. Two settings are configured, both of which may be set by selecting the Postflight Script, choosing Get Info and then Executable tab:

- Administration Rights: admin\_rights
- Password Strength: pass\_strength

[![image.png](https://kb.filewave.com/uploads/images/gallery/2025-03/scaled-1680-/L30TD6e7XxlGnvq5-image.png)](https://kb.filewave.com/uploads/images/gallery/2025-03/L30TD6e7XxlGnvq5-image.png)

Possible Values:

<table border="1" id="bkmrk-environment-variable" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.333333%;"></col><col style="width: 33.333333%;"></col><col style="width: 33.333333%;"></col></colgroup><tbody><tr><td>Environment Variable</td><td>Value</td><td>Outcome</td></tr><tr><td rowspan="2">admin\_rights  
</td><td>0</td><td>Any user may change settings</td></tr><tr><td>1 (Recommended)</td><td>Only administrators may change settings</td></tr><tr><td rowspan="4">pass\_strength  
</td><td>3 (Recommended)</td><td>No password</td></tr><tr><td>2</td><td>10 Character Password</td></tr><tr><td>1</td><td>6 Character Password</td></tr><tr><td>0</td><td>8 Character Password</td></tr></tbody></table>

<p class="callout info">Setting No Password for password strength, prevents anything other than FileWave from connecting to devices through TeamViewer Host.</p>

<p class="callout success">Triggering a reinstall Fileset should set the above settings to match those in the Fileset.</p>

##### Post-Uninstallation Script:

The 'mac\_teamviewer\_uninstaller.sh' script uninstalls TeamViewer if an association or deployment no longer exists.

### Updates

The software should auto update to latest version. If you would like to download the latest installer though you can always get it from [https://go.filewave.com/tvhost](https://go.filewave.com/tvhost) and if you go to it on a macOS system then the PKG will download, and if you go to it on Windows the EXE will download.

<p class="callout success">Don't forget to upgrade the full TeamViewer version on the Admin device.</p>

## Related Content

- [TeamViewer macOS Mass Deployment Guide](https://community.teamviewer.com/English/kb/articles/50739-mass-deployment-on-macos)
- [Latest TV Host (Download from macOS or Windows to get that platform's installer)](https://go.filewave.com/tvhost)

<div data-extension-key="panel" data-extension-type="com.atlassian.confluence.macro.core" data-layout="default" data-local-id:="22e3b8ff-f1d8-4bb9-a374-a0a324a7b318" data-node-type="bodied-extension" data-parameters="{"macroParams":{"title":{"value":"Related Content"}},"macroMetadata":{"macroId":{"value":"4eb17d73-e6c2-4362-94c2-6f740babe8cf"},"schemaVersion":{"value":"1"},"title":"Panel"}}" id="bkmrk--6"></div>