Lightweight system audit agent for ScoutOpsBot.
ScoutOps Agent is a read-only Bash script that collects basic system, disk, network, and security information from a Linux server and exports it as a JSON report for analysis via ScoutOpsBot in Telegram.
Run this command on the server you want to analyze:
curl -fsSL https://raw.githubusercontent.com/CynepMyx/scoutops-agent/main/server_scout.sh
-o scoutops.sh && chmod +x scoutops.sh && sudo ./scoutops.sh --preset=basic --json
After execution, the script will generate a file like:
server-scout_YYYY-MM-DD_HH-MM-SS.json
Send this JSON file to @ScoutOpsBot in Telegram to receive analysis and recommendations.
The agent collects:
- Disk usage and mount points
- Open ports and listening services
- Firewall and fail2ban status
- System updates status
- Basic OS information
- Docker overlay and container disk usage (if present)
- Read-only (no system changes)
- No configuration modification
- No outbound network connections
- No credentials or secrets collected
The script only reads system state and writes a local JSON file.
- Linux server
- Bash
- Common system utilities (df, ss, systemctl, ufw, iptables)
- Root access recommended for full visibility
- JSON only
- Text output is not supported by ScoutOpsBot
- Maximum supported file size: 10 MB
This repository contains only the agent.
Analysis, storage, and history are handled by ScoutOpsBot. Agent and bot are intentionally separated.
MIT License.
Free to use, modify, and redistribute. Attribution is appreciated.
This tool is provided as-is. Always review scripts before running them on production systems.