Get Started
Installation
The Hektorix Agent is a lightweight monitoring service that collects system information and security data from your Windows workstations. This guide covers installation, updates, and removal procedures.
Installation Methods
GUI Installation
- Download the
HektorixInstaller.exefile - Run the installer by double-clicking
- Follow the installation wizard
- Enter your license key when the screen appears
Silent Installation
For automated deployments, use the command line:Replace
XXXX-XXXX-XXXX-XXXX with your actual license keySystem Requirements
| Operating System | Windows 10 64-bit or later |
|---|---|
| Dependencies | Visual C++ 2015-2022 (installed automatically) |
| Permissions | Administrator rights required for installation |
Installed Services
The agent installs two Windows services:| Service | Description | Account | Startup Type |
|---|---|---|---|
| HektorixAgent | Collects and sends telemetry data | LocalSystem | Automatic |
| HektorixUpdater | Downloads and applies updates | LocalSystem | Automatic (starts every time the computer starts) |
Updates
Automatic Updates
The HektorixUpdater service automatically downloads and applies updates when available.Uninstallation
Via Windows Settings
- Open Settings → Apps → Installed apps
- Find Hektorix Agent
- Click the three dots (**…**) → Uninstall
Command Line Uninstallation
Uninstalling will stop all services and remove all agent data from the system
Troubleshooting
Installation Logs
All operations generate detailed logs:- Command Line: Use
/log "C:\Path\to\logfile.log"parameter - Agent Logs: Located in
%PROGRAMDATA%\Hektorix Agent\logs
Common Issues
Installation fails with error code
Installation fails with error code
Check the installation log for detailed error messages. Ensure you have administrator privileges and sufficient disk space.
Services not starting after installation
Services not starting after installation
Verify Windows services are enabled and the LocalSystem account has necessary permissions. Check Windows Event Logs for service-specific errors.
Agent not appearing in dashboard
Agent not appearing in dashboard
Agent not appearing in dashboard”> Confirm your license key is correct and the machine has internet connectivity. The agent needs to communicate with our servers on first startup.
Mass Deployment
For deploying across multiple workstations, use your preferred management tool:Microsoft Intune
Group Policy (GPO)
Create a startup script with the silent installation commandThird-party RMM Tools
Most RMM platforms support custom script deployment with the command line parametersAfter installation, you can safely delete the original installer file. The agent maintains all necessary components for self-repair and uninstallation.