Agent Installation Issues
Common errors encountered during installation and how to fix them.
Antivirus Interference
The most common reason for installation failure is interference from third-party antivirus or EDR software.
Solution:
Please whitelist the following paths in your security software:
- C:\Program Files\PeakDesk\
- C:\ProgramData\PeakDesk\
- /usr/local/bin/peakdesk-agent (Linux/macOS)
Windows Installer Errors
Error 1603: Fatal error during installation
This is a generic Windows Installer error. It often means the installer doesn't have enough permissions.
Fix: Right-click the installer and select "Run as Administrator". If that fails, try running the installer from an elevated Command Prompt.
"The system administrator has set policies to prevent this installation"
This usually indicates a Group Policy restriction.
Fix: Check your Local Security Policy settings under "Software Restriction Policies" or consult your domain administrator.
Linux & macOS Errors
Permission Denied
Ensure you are running the install script with sudo.
Curl error: Could not resolve host
The device cannot reach our download servers. Check your DNS settings and firewall rules.