Cross-platform server telemetry agent for Statrix.
Lightweight agents for Linux, macOS, and Windows that report CPU, RAM, disk, network, and service metrics to your Statrix instance.
| Platform | Script | Scheduler |
|---|---|---|
| 🐧 Linux | shell/linux/statrix_install.sh |
cron or systemd timer |
| 🍎 macOS | shell/macOS/statrix_install.sh |
launchd |
| 🪟 Windows | shell/windows/statrix_install.ps1 |
Windows Scheduled Task |
The recommended way to install the agent is through the Statrix dashboard:
- 🖥️ Create a Server Agent monitor in the dashboard (https://{your-statrix-app-url}/edit).
- 📋 Copy the generated install command.
▶️ Run it on the target machine with elevated privileges (sudo/ Administrator).
The command includes your endpoint URL, SID, and monitoring options — no manual configuration needed.
- 🔐 Use HTTPS in production — agent payloads contain server metrics.
- 🔑 Protect the SID — it authenticates the agent to your Statrix instance. Treat it as a secret.
- 👤 Least privilege — run the agent with minimal permissions where possible.
- 🛡️ Firewall — restrict outbound traffic to your Statrix endpoint only.
The original monitoring agent concept is based on work by HetrixTools. Adapted and maintained by Statrix contributors.