winget install --id=sysmanage.sysmanage-agent -e SysManage Agent is the host-side daemon for the SysManage open-source fleet management platform. It registers the host with a SysManage server, reports inventory, applies declarative deployment plans (package install, firewall config, antivirus deployment, VM lifecycle), and surfaces real-time health metrics.
A lightweight, secure, cross-platform system monitoring agent that connects to SysManage Server via WebSocket for real-time remote management.
Complete documentation is available at sysmanage.org
SysManage Agent is a headless Python application designed to be installed on remote systems for centralized monitoring and management. It establishes a secure WebSocket connection to the SysManage Server and provides real-time system information, command execution capabilities, and health monitoring.
# Add the repository
echo "deb [trusted=yes] https://bceverly.github.io/sysmanage-docs/repo/deb stable main" | \
sudo tee /etc/apt/sources.list.d/sysmanage.list
# Update and install
sudo apt update
sudo apt install sysmanage-agent
# Configure
sudo nano /etc/sysmanage-agent.yaml
sudo systemctl restart sysmanage-agent
Supported: Ubuntu 22.04+, Debian 11+
EL9 (RHEL 9, Rocky 9, AlmaLinux 9, Oracle Linux 9, CentOS Stream 9):
sudo tee /etc/yum.repos.d/sysmanage.repo << EOF
[sysmanage]
name=SysManage Agent Repository
baseurl=https://bceverly.github.io/sysmanage-docs/repo/rpm/el9/x86_64
enabled=1
gpgcheck=0
EOF
sudo dnf install sysmanage-agent
EL8 (RHEL 8, Rocky 8, AlmaLinux 8, Oracle Linux 8):
# Install Python 3.11 first
sudo dnf module install python311
sudo tee /etc/yum.repos.d/sysmanage.repo << EOF
[sysmanage]
name=SysManage Agent Repository
baseurl=https://bceverly.github.io/sysmanage-docs/repo/rpm/el8/x86_64
enabled=1
gpgcheck=0
EOF
sudo dnf install sysmanage-agent
Fedora 38+:
sudo tee /etc/yum.repos.d/sysmanage.repo << EOF
[sysmanage]
name=SysManage Agent Repository
baseurl=https://bceverly.github.io/sysmanage-docs/repo/rpm/fedora/39/x86_64
enabled=1
gpgcheck=0
EOF
sudo dnf install sysmanage-agent
Download packages from GitHub Releases
š For detailed platform-specific installation instructions, visit sysmanage.org/docs/agent/installation.html
# 1. Clone and setup
git clone https://github.com/bceverly/sysmanage-agent.git
cd sysmanage-agent
# 2. Create virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Note: On BSD systems (FreeBSD, OpenBSD, NetBSD), use: . .venv/bin/activate
# Windows users: .venv\Scripts\activate
# 3. Install dependencies
pip install --upgrade pip
pip install -r requirements.txt
# 4. Start the agent
gmake start # Standard agent
# gmake start-privileged # Privileged agent (for package management)
SysManage Agent includes automatic server discovery that eliminates the need for manual configuration in most scenarios:
Create configuration file at:
/etc/sysmanage-agent.yamlC:\ProgramData\SysManage\sysmanage-agent.yamlš For complete configuration options, visit sysmanage.org/docs/agent/configuration.html
SysManage Agent implements multiple layers of security:
š For complete security documentation, visit sysmanage.org/docs/security/
The agent requires elevated privileges for certain system management operations, particularly package management. Cross-platform privileged runner scripts are included:
run-privileged.sh - Works on macOS, Linux, and OpenBSDrun-privileged.cmd and run-privileged.ps1 - Batch and PowerShell scriptsš For detailed privileged execution setup, visit sysmanage.org/docs/agent/privileged-execution.html
# Run all tests with coverage
make test
# Direct pytest execution
python -m pytest tests/ -v
# Run with coverage
python -m pytest tests/ --cov=. --cov-report=html
# Run linting
make lint
SysManage Agent supports 14 languages for logging and system messages:
| Language | Code | Status |
|---|---|---|
| English | en | ā Complete |
| Spanish | es | ā Complete |
| French | fr | ā Complete |
| German | de | ā Complete |
| Italian | it | ā Complete |
| Portuguese | pt | ā Complete |
| Dutch | nl | ā Complete |
| Japanese | ja | ā Complete |
| Simplified Chinese | zh_CN | ā Complete |
| Traditional Chinese | zh_TW | ā Complete |
| Korean | ko | ā Complete |
| Russian | ru | ā Complete |
| Arabic | ar | ā Complete |
| Hindi | hi | ā Complete |
sysmanage-agent/
āāā main.py # Agent entry point
āāā config.py # Configuration management
āāā registration.py # Server registration logic
āāā websocket_client.py # WebSocket communication
āāā system_info.py # System information collection
āāā command_executor.py # Command execution engine
āāā tests/ # Test suite
āāā requirements.txt # Python dependencies
āāā run-privileged.sh # Privileged execution script
make lint test)š For detailed contribution guidelines, visit sysmanage.org/docs/
This project is licensed under the GNU Affero General Public License v3.0. See LICENSE for details.