Agent Setup Guide
Install and configure the DeskTrust desktop agent.
System Requirements
- - Windows 10 or later (64-bit)
- - Node.js 18 or later (nodejs.org)
- - Internet connection
- - Agent Key from your administrator
- - ~100 MB disk space (including dependencies)
Installation Steps
Install Node.js (if not installed)
Download from nodejs.org and run the installer. Choose the LTS version. Restart your computer after installation.
Download DeskTrust Agent
Get the installer from your admin dashboard (Settings > Download Agent) or from desktrust.com/download.
Run the Installer
Double-click DeskTrust-Setup.exe. Accept the Terms & Conditions. Choose install location (default recommended). Click Install.
Configure the Agent
The setup wizard opens after installation. Enter: Server URL (https://www.desktrust.com), your Agent Key, email, timezone, and work hours.
Verify It Works
The DeskTrust icon should appear in your system tray. Your admin should see you as "Online" in their dashboard within 30 seconds.
File Locations
# Default install location
%LOCALAPPDATA%\DeskTrust\
# Configuration
%LOCALAPPDATA%\DeskTrust\config.json
# To reconfigure, delete config.json and run setup again
del "%LOCALAPPDATA%\DeskTrust\config.json"
Auto-Start on Boot
DeskTrust automatically adds itself to Windows startup. The agent starts when you log in and runs in the background. To disable auto-start, search "Startup Apps" in Windows Settings and toggle DeskTrust off.
Uninstalling
Go to Windows Settings > Apps > Installed Apps > find DeskTrust Agent > click Uninstall. Or run uninstall.bat from the install folder. This removes all files, shortcuts, and registry entries.
Troubleshooting
Agent shows "Connecting..." and never connects
Check that the Server URL is correct (https://www.desktrust.com) and that your internet connection is working. Verify the Agent Key is correct by checking with your admin.
Node.js not found error
Download and install Node.js from nodejs.org (LTS version). After installation, restart your computer to update the system PATH.
Tray icon not appearing
Click the desktop shortcut again. If still not showing, check the hidden icons area in the system tray (click the ^ arrow). You may need to restart your computer.
npm install fails
Check your internet connection. If behind a corporate firewall, you may need to configure npm proxy settings. Contact your IT admin.
Agent key rejected
Verify the key is copied correctly (no extra spaces). If the key was regenerated by your admin, you need the new key. Delete config.json from the install folder and run setup again.
Screenshots not appearing in admin dashboard
Check that the employee status shows "Online" in the dashboard. If it shows "Offline", the agent may not be running. Check the system tray for the DeskTrust icon.