The install command fails or the installer is blocked
The RMM command downloads the installer frominstall.telivy.com. An antivirus, EDR,
application allowlisting tool, or web filter that blocks that download or the installer
stops the install.
- Allow Telivy before you deploy, as listed in Allow Telivy in AV and EDR. If the client uses ThreatLocker, add the policy in Allow Telivy in ThreatLocker.
- Make sure the RMM runs the command as Administrator or System on Windows, and as root on macOS. A command run as a standard user cannot install the agent.
- Run the command again.
telivy_install.log in the folder it ran from.
Attach it if you contact support.
Telivy installed but the device never appears
A device appears under Setup > Deploy Agent > Deployment Status and on Inventory > Endpoints after its first check-in, which can take up to an hour after the install.- Check that the agent is running on the device.
- Windows: in PowerShell, run
Get-Service TelivyAgent. The status should be Running. - macOS: in Terminal, run
sudo launchctl list | grep com.cytracom.telivy.agent. A line should come back.
- Windows: in PowerShell, run
- Check that the device can reach
agent-v1.telivy.comandinstall.telivy.comon port 443. Firewalls, web filters, and SSL inspection that block*.telivy.comstop the check-in. - Look for the device in your other assessments. The install command carries one assessment’s ID, so a command copied from a different assessment registers the device there. Uninstall it from that assessment and install it again with the right command.
The device shows Agentless Scan
The device was scanned by the agentless scanner, not by the agent. This usually happens when an EDR blocked the agent installer and the scanner still finished. Allow Telivy in the EDR, then run the Agent Installer on the device. See Devices scanned without the agent.The device shows Offline or an old Last Seen date
The agent checks in once an hour, and Last Seen on Inventory > Endpoints is the time of the last check-in. A device that is switched off, asleep, or off the network shows Offline until it checks in again. If the device is on and online but still not checking in:- Restart the agent.
- Windows:
Restart-Service TelivyAgentin PowerShell as Administrator. - macOS:
sudo launchctl kickstart -k system/com.cytracom.telivy.agentin Terminal.
- Windows:
- Check that a security tool has not started blocking
*.telivy.comor the agent files since the install, for example after a policy change. - If it still does not check in, reinstall the agent with the assessment’s install command.
The scan stays In progress
A full scan needs the device to stay on for about two hours without interruption. The PII scan takes longest, and devices with many files take longer. A laptop that sleeps or shuts down restarts the remaining work at the next check-in. If a scan is still In progress after the device has been online for a day, contact support with the device name and assessment.Mac results are missing PII or passwords
The agent runs without Full Disk Access and Keychain access, but PII and password results stay incomplete until the person using the Mac approves both. Ask them to follow Grant the permissions the agent needs. An RMM or MDM command cannot grant these permissions, so the approval has to be done on each Mac.Logs to send to support
When you contact support, include the device name, the assessment, and these files from the device.Related guides
Allow Telivy in AV and EDR
Domains, folders, and executables to allow
Installation FAQ
Short answers on installing and checking the agent
Install on Windows
RMM command, installer, and agentless scan
Install on macOS
RMM or MDM command, .dmg installer, and permissions