Install An Endpoint Agent
Report CPU, memory, disk and service health from a Windows or Linux system.
Before installing
Use Node.js 22.13 or newer and install the Sysavia source on the target host. From that directory, run npm ci. Use HTTPS for the panel URL outside a trusted test environment.
In Organization Settings, generate an agent credential. Keep it private. Match the agent ID in the host configuration to the system you assign in the panel.
Create the configuration
Copy agent.example.json to a private location and edit it. A minimal Linux example is:
{
"id": "app-01",
"server": "https://panel.example.com/t/ORGANIZATION-ID",
"services": {
"web": {"unit": "nginx.service", "actions": ["restart"]}
},
"allowRemoteScripts": false,
"remoteScriptIds": []
}
The server URL includes the organization path. Use the actual organization ID. Service keys such as web are stable identifiers; unit is the local systemd unit or Windows service name.
Start and verify
Set AGENT_TOKEN in the host’s environment or service manager, then run:
node agent.mjs /etc/sysavia/agent.json
Check the console for successful heartbeats, then inspect the assigned system in Sysavia. Its readings should become current. Verify CPU, memory and disk against the host before building alerts around them.
Run it continuously
Use your normal systemd service or Windows service wrapper to keep the process running and restart it after a host reboot. Give it only the local permissions required for its allowed tasks. A service restart may require more privilege than reading metrics.
Allow actions deliberately
The agent checks its local service action list, script IDs and transfer jobs. Creating a panel automation does not bypass that list. Your organization must have live actions enabled; contact Sysavia support if an action is unavailable. Start with a single test service and verify both successful and failed recovery.
If reports stop
Check the panel URL, organization path, token, DNS and outbound HTTPS first. An expired observation becomes Unknown. Do not replace a missing heartbeat with an assumption that the host is healthy.