Overview π₯
During installation of the Liongard Windows Agent, the installer may fail when attempting to start the agent service. This issue typically presents as a service startup failure related to permissions or Windows Event Log registration conflicts.
This article explains:
Why the error occurs
How to safely remediate it
When to use the Liongard install script
When to escalate to Support
Common Error Messages π§
You may see one or more of the following errors during installation:
Service Liongard Agent (liongardagent.exe) failed to start. Verify you have sufficient privileges to start system services.
Or in Windows Event Viewer:
Service cannot be started. System.ArgumentException:The source LiongardAgentSVC is not registered in log LiongardAgentLog. (It is registered in log Application.) The Source and Log properties must be matchedβ¦
Why Does This Happen? π€
This issue is most commonly caused by:
β Stale or incorrect Windows Event Log registry entries
π Previous failed installs or partial uninstalls
π Insufficient permissions during installation
π‘οΈ Interference from endpoint security software (AV / EDR)
The Liongard Agent service on Windows is now named:
Component | Correct Name |
Agent Service | LiongardAgent |
Event Log Source | LiongardAgentSVC |
If Windows has an incorrect or conflicting Event Log registration, the service cannot startβeven if the binaries install successfully.
Steps to Resolve π§βπ«
β οΈ Important: The steps below require local administrator privileges.
1οΈβ£ Open the Windows Registry Editor
Press Win + R
Type
regeditPress Enter
2οΈβ£ Navigate to the Event Log Registry Path
HKLM\SYSTEM\CurrentControlSet\Services\EventLog\Application
3οΈβ£ Locate the LiongardAgentSVC Key
Look for a registry entry named LiongardAgentSVC
4οΈβ£ Export the Registry Key (Strongly Recommended)
π¦ This is a precautionary backup.
Right-click LiongardAgentSVC
Select Export
Save the file to a known location
π‘ If any unexpected behavior occurs later, this key can be restored.
5οΈβ£ Delete the LiongardAgentSVC Registry Entry
Right-click LiongardAgentSVC
Select Delete
Confirm the deletion
6οΈβ£ Reattempt the Installation
The script ensures:
Proper permissions
Clean service registration
Correct SYSTEM-level execution
Validation After Installation π¨βπ§
After reinstalling, confirm:
β Service exists:
services.mscβ LiongardAgentβ Service status: Running
β Event logs: Event Viewer β Application β No new
LiongardAgentSVCerrors
Security & Best Practice Notes ποΈ
π Registry changes should be minimal and intentional
Only delete the specific
LiongardAgentSVCkeyDo not modify other Event Log entries
Ensure endpoint security tools are not blocking service creation
When to Contact Support π¦
Contact Liongard Support if:
The service still fails to start after reinstall
The registry key recreates incorrectly
Event Viewer shows repeated startup exceptions
EDR/AV logs indicate blocked service activity
π When opening a ticket, include:
Agent version
Windows OS version
Installer logs (if available)
Relevant Event Viewer entries
Summary π€©
Liongard Windows Agent service is now LiongardAgent
Event log source LiongardAgentSVC must be registered correctly
Stale registry entries can block service startup
Safely removing the conflicting key resolves the issue
Always reinstall using the official install script