Knowledge Base

Back to support overview

You can configure a proxy for the TeamViewer Embedded agent to enable secure and controlled internet access. This setup is useful when your network requires proxy authentication or routing. The configuration involves two steps: first, defining the proxy settings (IP, port, and username), and second, securely setting the proxy password.

This article applies to all TeamViewer Tensor license holders.

Prerequisites

  • Install the TeamViewer Embedded agent on your device.
  • Ensure you have access to the device’s terminal or configuration files.

Requirements

  • Linux-based system (Debian package supported)
  • Administrative privileges to run commands
  • Proxy server details (IP, port, username, and password)

How to configure the proxy

Set proxy type

You must set the proxy type to manual for the configuration to work.

Using agent.conf

Proxy_Type = 2

Using command line

teamviewer-iot-agent configure set ProxyType 2

Set proxy IP and port

Using agent.conf

Proxy_IP = "192.168.1.1:3128"

Using command line

teamviewer-iot-agent configure set ProxyIP '192.168.1.1:3128'

Set proxy username

Using agent.conf

ProxyUsername = 'your-username'

Using command line

teamviewer-iot-agent configure set ProxyUsername 'your-username'

Set proxy password

For security reasons, you must set the password using the command line. It will be stored encrypted.

Using command line

sudo teamviewer-iot-agent configure set ProxyPassword 'your-password'

Alternatively

sudo /usr/libexec/teamviewer-iot-agent/teamviewer-iot-agent proxy --password 'your-password'