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'