This article provides technical guidance for resolving issues where the Revealed Agent frequently loses its connection to the Teramind server.
Symptoms
The Agent status toggles between "Connected" and "Reconnecting".
Users are frequently prompted with "Reconnection" or "Connected" pop-up messages.
The Agent window displays a "Not active" status even when a task is selected.
Activities performed during the disconnection period do not appear on the dashboard in real-time.
Causes
Antivirus or EDR Interference: Security software may flag the Agent as a false positive, killing or suspending its background services like
tsvchst.exeordwm.exe.Unstable Network or Firewall Blocks: Intermittent internet connectivity or restrictive firewall rules prevent the Agent from reaching necessary server ports.
SSL/TLS Handshake Issues (On-Premises): In On-Premises or Private Cloud environments, the local machine may not trust the server's security certificate, causing the connection to drop immediately.
Incorrect Instance: The Agent is attempting to connect to the wrong instance. This can happen if you used the
TMROUTERparameter with a wrong instance, or recently changed your Hostname.
Solutions
Add the Agent’s installation directory and core executables to your security software’s exclusion list. Refer to the Antivirus & EDR Configuration Guide for specific file paths.
Verify that all Teramind server IP addresses and ports are whitelisted in your firewall. Especially, the Management interface port (default is usually 443) and any custom Load balancer ports are critical for the Agent connectivity. You should check out this article to learn more about using tools like
ping,tracert, ortelnetto verify if the Teramind hosts and ports are reachable from your network.For On-Premises/Private Cloud, manually install the Teramind server's trusted certificate (
.pemor.crt) into the endpoint's Trusted Root Certification Authorities store to establish a permanent secure trust.Verify and correct instance address in the Agent's configuration file*. Ensure the
router=line matches your Teramind instance address. For example:router=acme.teramind.co).
Alternatively, you can download the Agent and reinstall it.
*Default configuration file locations for the Revealed Agent:
Windows:
C:\ProgramData\Teramind Agent\config\config.cfgMac:
Macintosh HD > usr > local > teramind > agent > etc > agent.conf
