Read this article in  ChineseFrench | German | Japanese | Spanish


This article applies to all TeamViewer customers with a Corporate or Tensor subscription plan using version 15.x. or newer

Supported macOS versions: 10.11, 10.12, 10.13, 10.14

This article explains how you can install, update, uninstall TeamViewer Host and TeamViewer Full in a mass deployment scenario on macOS. In order to achieve this you are required to have basic knowledge about command line installations on macOS.

Install the standard Host version of TeamViewer

Required installer:

  • TeamViewerHost.pkg:
    1. Download the Host DMG package from the TeamViewer website.
    2. Extract the PKG from the downloaded DMG
      1. If you downloaded the DMG file to a Windows machine, you can extract the PKG file from the DMG with the help of some ZIP tool (e.g. 7ZIP). The package "Install TeamViewerHost.pkg" can be found in the folder "TeamViewerHost\" inside the DMG package
      2. If you downloaded the DMG package to a Mac, you can extract the "Install TeamViewerHost.pkg" package by double clicking on the DMG package. The macOS installer window will open and you can drag&drop the "Install TeamViewerHost.pkg" package directly to the desktop.

Steps:

Enter the following command into the terminal:

sudo installer -pkg "Install TeamViewerHost.pkg" -target /

The parameter -target defines the path where you want your installation to be located.

Install the standard Host version of TeamViewer silently

Required installer:

  • TeamViewerHost.pkg:
    1. download the Host DMG package from the TeamViewer website.
    2. Extract the PKG from the downloaded DMG
      1. If you downloaded the DMG file to a Windows machine, you can extract the PKG file from the DMG with the help of some ZIP tool (e.g. 7ZIP). The package "Install TeamViewerHost.pkg" can be found in the folder "TeamViewerHost\" inside the DMG package
      2. If you downloaded the DMG package to a Mac, you can extract the "Install TeamViewerHost.pkg" package by double clicking on the DMG package. The macOS installer window will open and you can drag&drop the "Install TeamViewerHost.pkg" package directly to the desktop.

Steps:

  1. Create an XML file called (e.g.: choices.xml) and enter the following content:
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <array>
    <dict>
    <key>attributeSetting</key>
    <integer>1</integer>
    <key>choiceAttribute</key>
    <string>selected</string>
    <key>choiceIdentifier</key>
    <string>com.teamviewer.teamviewerhostSilentInstaller</string>
    </dict>
    </array>
    </plist>

    The name of the choiceIdentifier for older version prior to version 15 of TeamViewer included the version of TeamViewer, e.g.: "com.teamviewer.teamviewerhost14SilentInstaller". Be aware that with version 15 this was changed!

  2. (Optional) verify if your configuration will be applied correctly
    1. Execute the following command:
      installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewerHost.pkg -target /
    2. This will result in an output that should look similar to this:
      <?xml version="1.0" encoding="UTF-8"?>
      <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
      <plist version="1.0">
      <array>
      <dict> ... </dict>
      <dict> ... </dict>
      <dict>
      <key>attributeSetting</key>
      <false/>
      <key>choiceAttribute</key>
      <string>visible</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerhostSilentInstaller</string>
      </dict>
      <dict>
      <key>attributeSetting</key>
      <true/>
      <key>choiceAttribute</key>
      <string>enabled</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerhostSilentInstaller</string>
      </dict>
      <dict>
      <key>attributeSetting</key>
      <integer>1</integer>
      <key>choiceAttribute</key>
      <string>selected</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerhostSilentInstaller</string>
      </dict>
      </array>
      </plist>
      Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"
      sudo installer -applyChoiceChangesXML choices.xml -pkg Install TeamViewerHost.pkg -target /
    3. In case you want to rollout to macOS Mojave (macOS 10.14):
      1. Go to your MDM solution, e.g. Mobile Iron, JAMF Pro, VMWare, or Mirador
      2. Configure your MDM to rollout the Accessibility permissions (according to the manual of your MDM solution provider).
        An example for an MDM configuration by using Mobile Iron can be found here: Add Teamviewer apps to macOS Mohjave accessibility with Mobile Iron.

Install the customized Host version of TeamViewer

Required installer:

  • TeamViewerHost.pkg:
    1. download the Host DMG package from the TeamViewer website.
    2. Extract the PKG from the downloaded DMG
      1. If you downloaded the DMG file to a Windows machine, you can extract the PKG file from the DMG with the help of some ZIP tool (e.g. 7ZIP). The package "Install TeamViewerHost.pkg" can be found in the folder "TeamViewerHost\" inside the DMG package
      2. If you downloaded the DMG package to a Mac, you can extract the "Install TeamViewerHost.pkg" package by double clicking on the DMG package. The macOS installer window will open and you can drag&drop the "Install TeamViewerHost.pkg" package directly to the desktop.

Steps:

  1. Create a new customization or open an existing one (See How to customize your Host for details)
  2. Copy the ConfigurationID from your customized Host.
  3. Open the terminal or execute the pkg via a script.
  4. Add the ConfigurationID to the filename in the command line:
  5. sudo installer -pkg "Install TeamViewerHost-idc<ConfigurationID>.pkg" -target /

Summary of parameters

Parameter

Description

-idc

The Configuration ID is needed to install a Custom Host. It can't be used to configure a Full client installation.
The ConfigurationID can be retrieved from the Management Console.

Install the customized Host version of TeamViewer silently

Required installer:

  • TeamViewerHost.pkg:
    1. Download the Host DMG package from the TeamViewer website.
    2. Extract the PKG from the downloaded DMG
      1. If you downloaded the DMG file to a Windows machine, you can extract the PKG file from the DMG with the help of some ZIP tool (e.g. 7ZIP). The package "Install TeamViewerHost.pkg" can be found in the folder "TeamViewerHost\" inside the DMG package
      2. If you downloaded the DMG package to a Mac, you can extract the "Install TeamViewerHost.pkg" package by double clicking on the DMG package. The macOS installer window will open and you can drag&drop the "Install TeamViewerHost.pkg" package directly to the desktop.

Steps:

  1. Create an XML file called (e.g.: choices.xml) and enter the following content:
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <array>
    <dict>
    <key>attributeSetting</key>
    <integer>1</integer>
    <key>choiceAttribute</key>
    <string>selected</string>
    <key>choiceIdentifier</key>
    <string>com.teamviewer.teamviewerhostSilentInstaller</string>
    </dict>
    </array>
    </plist>

    The name of the choiceIdentifier for older version prior to version 15 of TeamViewer included the version of TeamViewer, e.g.: "com.teamviewer.teamviewerhost14SilentInstaller". Be aware that with version 15 this was changed!

  2. (Optional) verify if your configuration will be applied correctly
    1. execute the following command:
      installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewerHost.pkg -target /
    2. This will result in an output that should look similar to this:
      <?xml version="1.0" encoding="UTF-8"?>
      <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
      <plist version="1.0">
      <array>
      <dict> ... </dict>
      <dict> ... </dict>
      <dict>
      <key>attributeSetting</key>
      <false/>
      <key>choiceAttribute</key>
      <string>visible</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerhostSilentInstaller</string>
      </dict>
      <dict>
      <key>attributeSetting</key>
      <true/>
      <key>choiceAttribute</key>
      <string>enabled</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerhostSilentInstaller</string>
      </dict>
      <dict>
      <key>attributeSetting</key>
      <integer>1</integer>
      <key>choiceAttribute</key>
      <string>selected</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerhostSilentInstaller</string>
      </dict>
      </array>
      </plist>
      Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"
      sudo installer -applyChoiceChangesXML choices.xml -pkg "Install TeamViewerHost-idc<ConfigurationID>.pkg" -target /
    3. In case you want to rollout to macOS Mojave:
      1. Go to your MDM solution, e.g. Mobile Iron, JAMF Pro, VMWare, or Mirador
      2. Configure your MDM to rollout the Accessibility permissions (according to the manual of your MDM solution provider).
        An example for an MDM configuration by using Mobile Iron can be found here: Add Teamviewer apps to macOS Mohjave accessibility with Mobile Iron.

Install the standard version of TeamViewer

Required installer:

  • TeamViewer.pkg
    1. Download the Full Client DMG package from the TeamViewer website.
    2. Extract the PKG from the downloaded DMG
      1. If you downloaded the DMG file to a Windows machine, you can extract the PKG file from the DMG with the help of some ZIP tool (e.g. 7ZIP). The package "Install TeamViewer.pkg" can be found in the folder "TeamViewer\" inside the DMG package
      2. If you downloaded the DMG package to a Mac, you can extract the "Install TeamViewer.pkg" package by double clicking on the DMG package. The macOS installer window will open and you can drag&drop the "Install TeamViewer.pkg" package directly to the desktop.

Steps:

  1. Open the terminal or execute pkg via a script.
  2. Type into the terminal: sudo installer -pkg "Install TeamViewer.pkg" -target /
    sudo installer -pkg "Install TeamViewer.pkg" -target /
    The parameter -target defines the path where you want your installation to be located.

    Settings cannot be provided during the installation process on macOS.

Install the standard version of TeamViewer silently

Required installer:

  • TeamViewer.pkg
    1. Download the Full Client DMG package from the TeamViewer website.
    2. Extract the PKG from the downloaded DMG
      1. If you downloaded the DMG file to a Windows machine, you can extract the PKG file from the DMG with the help of some ZIP tool (e.g. 7ZIP). The package "Install TeamViewer.pkg" can be found in the folder "TeamViewer\" inside the DMG package
      2. If you downloaded the DMG package to a Mac, you can extract the "Install TeamViewer.pkg" package by double clicking on the DMG package. The macOS installer window will open and you can drag&drop the "Install TeamViewer.pkg" package directly to the desktop.

Steps:

  1. Create an XML file called (e.g.: choices.xml) and enter the following content:
    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <array>
    <dict>
    <key>attributeSetting</key>
    <integer>1</integer>
    <key>choiceAttribute</key>
    <string>selected</string>
    <key>choiceIdentifier</key>
    <string>com.teamviewer.teamviewerSilentInstaller</string>
    </dict>
    </array>
    </plist>

    the name of the choiceIdentifier for older version prior to version 15 of TeamViewer included the version of TeamViewer, e.g.: "com.teamviewer.teamviewerhost14SilentInstaller". Be aware that with version 15 this was changed!

  2. (Optional) verify if your configuration will be applied correctly
    1. Execute the following command:
      installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewer.pkg -target /
    2. This will result in an output that should look similar to this:
      <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> 
      <plist version="1.0">
      <array>
      <dict> ... </dict>
      <dict> ... </dict>
      <dict>
      <key>attributeSetting</key>
      <false/>
      <key>choiceAttribute</key>
      <string>visible</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerSilentInstaller</string>
      </dict>
      <dict>
      <key>attributeSetting</key>
      <true/>
      <key>choiceAttribute</key>
      <string>enabled</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerSilentInstaller</string>
      </dict>
      <dict>
      <key>attributeSetting</key>
      <integer>1</integer>
      <key>choiceAttribute</key>
      <string>selected</string>
      <key>choiceIdentifier</key>
      <string>com.teamviewer.teamviewerSilentInstaller</string>
      </dict>
      </array>
      </plist>
    3. Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"
      sudo installer -applyChoiceChangesXML choices.xml -pkg Install\ TeamViewer.pkg -target /
    4. In case you want to rollout to macOS Mojave:
      1. Go to your MDM solution, e.g. Mobile Iron, JAMF Pro, VMWare, or Mirador
      2. Configure your MDM to rollout the Accessibility permissions (according to the manual of your MDM solution provider).
        An example for an MDM configuration by using Mobile Iron can be found here: Add Teamviewer apps to macOS Mohjave accessibility with Mobile Iron.

Update a TeamViewer installation

Updating TeamViewer corresponds to the steps that are required for an installation:

  • Install the Standard Host Client Version of Teamviewer
  • Install the Customized Host Client Version of Teamviewer
  • Install the Standard Full Client Version of TeamViewer

Uninstall TeamViewer

A reason to uninstall your TeamViewer might be that you want to switch from a TeamViewer Host Client Version to a Full Client Version.

You can uninstall your TeamViewer only manually

Recommended way to uninstall TeamViewer is to use the AppCleaner from the Mac App Store:

  1. Download and install AppCleaner from the Mac App Store.
  2. Open AppCleaner and click the Finder icon.
  3. In the left menu, click Applications.
  4. Drag the TeamViewer application into AppCleaner.
  5. Click Remove.
  6. Enter your password and click OK.

The program has been uninstalled.

Perform an assignment

Prerequisites

  • TeamViewer is already installed.
  • The option "Start with system" is enabled.
  • TeamViewer service is running!
  • The assignment tool together with the application is installed under
    /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment
    (/Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment).

Steps:

  1. (Optional) Start the TeamViewer service process (only necessary if user is logged in via ssh) with the following command:
    sudo launchctl load /Library/LaunchDaemons/com.teamviewer.teamviewer_service.plist
    1. Run the assignment tool with sudo privileges on all devices that should be assigned. In order to do this in a mass deployment scenario, we advice you to use a script to call the assignment tool with the required parameters.
      • Host version:
        sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group <GROUP> -alias <COMPUTERNAME> -grant-easy-access 
      • Full version:
        sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN>
      • The device is assigned to the account that created the Custom TeamViewer Host module.
      • EasyAccess is (optionally) activated for the device.

Assignment options

The following table shows the possible assignment options (they are all optional).
There are some parameters that need a value (–alias MyAlias) or do not need a value (–reassign).
The options need to be added on the command line.

  • If you have parameter values with blanks (e.g. for the group name) use "<GROUP_NAME_WITH_BLANK>".
  • sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOAPITOKEN> -group "My Group" -alias "$ALIAS"
  • Parameter names are case sensitive
  • Proxy settings can be specified for the assignment within the ASSIGNMENTOPTIONS. There are additional proxy settings for the TeamViewer connection itself (as defined in the TeamViewer client options). These have to be set outside of the ASSIGNMENTOPTIONS.
  • You can also insert environment variables to your commands for installation/assignment to add dynamic values, e.g. for the alias. You can use environment variables by using $-notation. The following characters should not be contained in the variable values: $, @, `, ´ and variables should always be used within quotes.
    Example:
    1. export GROUP="MyGroup"
    2. export ALIAS="MyDevicename"
    3. sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOAPITOKEN> -group "$GROUP" -alias "$ALIAS"

Option

Description

-api-token <TOKEN>

API Token in order to do the assignment to the correct account

-alias [<name>]

Alias for the new device in the computers & contacts list. If the device is already in the contact list, no alias will be applied. The parameter can take the following values:

  1. -alias (without value) → alias of the computer will be the teamviewerID sudo
    /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -alias -group MyGroup
  2. -alias hallo → alias of the computer will be "hallo"
    sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -alias hello -group MyGroup
  3. alias paramter not specified → alias of this computer will be %computername%
    sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group MyGroup

-grant-easy-access

If you set this option easy access is granted after assignment (same as the "Grant easy access" option in the TeamViewer main window).

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -grant-easy-access -group MyGroup

-reassign

Assigns the device to the account even if the device is already assigned to an account.

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -reassign -group MyGroup

-group <name>

Name of the group in which the device will be added.

When the group doesn't exist it will be automatically created.

If the device is already present in the computers & contacts list in a different group, it won't be moved to the group.

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group MyGroup

Only required if no custom host is used, as there is already a default group defined in the custom configuration.

-group-id <ID>

This option is an alternative to use the --group parameter if the id of the group is known.

This might be useful in very large customer environments as it speeds up the assignment process. Usually using --group is sufficient.

Note that the ID must be prepended with a literal "g".

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -group-id g123

-wait <seconds>

With this parameter the waiting time for the assignment ca be specified in seconds. The default value of 30 (secs) should usually be sufficient.

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -wait 45 -group MyGroup

-proxy <name>:<port>

Url of your proxy (only for the assignment) in the format <name>:<port>, e. g. --proxy yourproxy:3201

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw mypass -group MyGroup

(warning) URL without http://

-proxy-user <name>

Username which is used for authentication against the proxy (only for the assignment).

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw mypass -group MyGroup

-proxy-pw <password>

Password which is used for authentication against the proxy (only for the assignment).

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw mypass -group MyGroup

-proxy-pw-base64 <encoded_password>

Same as --proxy-pw, but the password needs to be entered as a Base64 encoded string. Useful for passwords with special characters.

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <API TOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw-base64 bXlwYXNz -group MyGroup

 

Version history
Revision #:
39 of 39
Last update:
Friday
Updated by: