Knowledge Base

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.

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://web.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.
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 on the Design & Deploy tab on the left.
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 Remove assignment.