The TeamViewer Embedded agent is a powerful tool that allows you to remotely access and control IoT devices from anywhere in the world. To make the Embedded agent accessible, it needs to be assigned to your TeamViewer account. In this article, we will show you how to assign your TeamViewer Embedded agent to your account using different methods.

This article applies to all TeamViewer Embedded users.

How to assign a TeamViewer Embedded agent

📌Note: To assign a TeamViewer Embedded agent, you must create a TeamViewer account. You can create a TeamViewer account via the Embedded dashboard at https://iot.teamviewer.com/.

Assign a device using the assignment token

  1. Sign in to https://iot.teamviewer.com/ and click on the account name in the upper right corner.
  2. Select Assignment token from the dropdown menu and copy the token from the grey box.
    Note: If you are configuring a NAS device, please follow the steps described in the Assign a NAS device (QNAP / Synology) section.
  3. Start the agent using the command $ systemctl start teamviewer-iot-agent
  4. Call the assignment command $ teamviewer-iot-agent assign <the-assignment-token>

Assign a device using the assignment ID

  1. Sign in to https://web.teamviewer.com/ and click the Admin settings tab and, within the Device Management menu, click Rollout set-up.
  2. Create a rollout configuration, as described in Step 1 of this article.
  3. Copy the assignment ID from the assignment configuration by ticking the respective box and clicking Copy ID.
  4. Start the agent using the command $ systemctl start teamviewer-iot-agent
  5. Call the assignment command $ teamviewer-iot-agent assign <the-assignment-id>

Assign a device using the assignment token (for Embedded Monitoring only)

📌Note: This method is only to be used if you are using Embedded Monitoring on your device.

  1. Sign in to https://iot.teamviewer.com/ and click on the account name in the upper right corner.
  2. Select Assignment token from the dropdown menu and copy the token from the grey box.
  3. Start the agent using the command $ systemctl start teamviewer-iot-agent
  4. Call the assignment command $ teamviewer-iot-agent assign --legacy-v1 <the-assignment-token> --group 'MyGroup'

Assign a NAS device (QNAP / Synology)

To assign a NAS device (QNAP / Synology):

  1. Open the TeamViewer app and click Assign device.
  2. In the window that pops up, enter your assignment token or assignment ID.

Unassign the NAS device

To unassign the NAS device, open the TeamViewer app and click Unassign all.

Difference between assignment token and assignment ID

Assignment Token

  • Legacy assignments; can still be used with --legacy-v1 switch
  • Short form (e.g., 123456-XXXXXXXXXXXXXXXXXXX)
  • Originally created by any user; repurposed to the new assignment method (assignment ID)

Assignment ID

  • Newly introduced for assignments
  • Long form (e.g., 123456ABCXXXXXXXXXXXXXXXX[...]XXXXXXXXXXXXXXXXXXXXXX)