SysManage Agent v3.3.0.0
End of phase 16
Multi-platform system management agent with support for Linux, BSD, macOS, and Windows.
Installation Instructions
Ubuntu/Debian
Download and install
wget https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent_3.3.0.0-1_amd64.deb
sudo apt install ./sysmanage-agent_3.3.0.0-1_amd64.deb
Configure and start
sudo nano /etc/sysmanage-agent.yaml
sudo systemctl enable --now sysmanage-agent
Flatpak (Universal Linux)
Add SysManage repository
flatpak remote-add --if-not-exists sysmanage https://sysmanage.org/sysmanage.flatpakrepo
Install the agent
flatpak install sysmanage org.sysmanage.Agent
Run service installation script
flatpak run --command=sysmanage-service-install org.sysmanage.Agent
Or download and install the bundle directly:
wget https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0.flatpak
flatpak install --user sysmanage-agent-3.3.0.0.flatpak
CentOS/RHEL 9
Download and install
wget https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-1.el9.x86_64.rpm
sudo dnf install ./sysmanage-agent-3.3.0.0-1.el9.x86_64.rpm
Configure and start
sudo nano /etc/sysmanage-agent.yaml
sudo systemctl enable --now sysmanage-agent
OpenSUSE Tumbleweed
Download and install
wget https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-1.opensuse.tumbleweed.x86_64.rpm
sudo zypper install ./sysmanage-agent-3.3.0.0-1.opensuse.tumbleweed.x86_64.rpm
Configure and start
sudo nano /etc/sysmanage-agent.yaml
sudo systemctl enable --now sysmanage-agent
OpenSUSE Leap 15
Download and install
wget https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-1.opensuse.leap.15.x86_64.rpm
sudo zypper install ./sysmanage-agent-3.3.0.0-1.opensuse.leap.15.x86_64.rpm
Configure and start
sudo nano /etc/sysmanage-agent.yaml
sudo systemctl enable --now sysmanage-agent
SUSE Linux Enterprise Server (SLES) 15
Download and install
wget https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-1.sles.x86_64.rpm
sudo zypper install ./sysmanage-agent-3.3.0.0-1.sles.x86_64.rpm
Configure and start
sudo nano /etc/sysmanage-agent.yaml
sudo systemctl enable --now sysmanage-agent
macOS
Download and install
curl -LO https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-macos.pkg
sudo installer -pkg sysmanage-agent-3.3.0.0-macos.pkg -target /
Configure and start
sudo nano /etc/sysmanage-agent.yaml
sudo launchctl load /Library/LaunchDaemons/com.sysmanage.agent.plist
Windows (x64)
Download and install (PowerShell as Administrator)
Invoke-WebRequest -Uri "https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-windows-x64.msi" -OutFile "sysmanage-agent-3.3.0.0-windows-x64.msi"
Start-Process msiexec.exe -ArgumentList "/i sysmanage-agent-3.3.0.0-windows-x64.msi /qn" -Wait -Verb RunAs
Configure and start
notepad C:\ProgramData\SysManage\sysmanage-agent.yaml
Start-Service SysManageAgent
Windows (ARM64)
Download and install (PowerShell as Administrator)
Invoke-WebRequest -Uri "https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-windows-arm64.msi" -OutFile "sysmanage-agent-3.3.0.0-windows-arm64.msi"
Start-Process msiexec.exe -ArgumentList "/i sysmanage-agent-3.3.0.0-windows-arm64.msi /qn" -Wait -Verb RunAs
Configure and start
notepad C:\ProgramData\SysManage\sysmanage-agent.yaml
Start-Service SysManageAgent
FreeBSD
Download and install
fetch https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0.pkg
sudo pkg add sysmanage-agent-3.3.0.0.pkg
Configure and start
sudo nano /etc/sysmanage-agent.yaml
sudo sysrc sysmanage_agent_enable=YES
sudo service sysmanage_agent start
NetBSD
Download and install
ftp https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0.tgz
sudo pkg_add sysmanage-agent-3.3.0.0.tgz
Copy rc.d script and configure
sudo cp /usr/pkg/share/examples/rc.d/sysmanage_agent /etc/rc.d/
sudo vi /usr/pkg/etc/sysmanage-agent/config.yaml
Enable and start
sudo sh -c 'echo sysmanage_agent=YES >> /etc/rc.conf'
sudo /etc/rc.d/sysmanage_agent start
Alpine Linux
Download the pre-built package for your Alpine version (3.19, 3.20, or 3.21)
For Alpine 3.21:
wget https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-alpine321.apk
doas apk add --allow-untrusted sysmanage-agent-3.3.0.0-alpine321.apk
For Alpine 3.20:
doas apk add --allow-untrusted sysmanage-agent-3.3.0.0-alpine320.apk
For Alpine 3.19:
doas apk add --allow-untrusted sysmanage-agent-3.3.0.0-alpine319.apk
Configure and start
doas cp /etc/sysmanage-agent/sysmanage-agent.yaml.example /etc/sysmanage-agent/sysmanage-agent.yaml
doas vi /etc/sysmanage-agent/sysmanage-agent.yaml
doas rc-update add sysmanage-agent default
doas rc-service sysmanage-agent start
OpenBSD (Pre-built Package - Recommended)
Download the pre-built package for your OpenBSD version (7.8 or 7.9)
For OpenBSD 7.9:
ftp https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-openbsd79.tgz
doas pkg_add sysmanage-agent-3.3.0.0-openbsd79.tgz
For OpenBSD 7.8:
doas pkg_add sysmanage-agent-3.3.0.0-openbsd78.tgz
Configure and start
doas cp /usr/local/share/examples/sysmanage-agent/sysmanage-agent.yaml /etc/sysmanage-agent.yaml
doas vi /etc/sysmanage-agent.yaml
doas rcctl enable sysmanage_agent
doas rcctl start sysmanage_agent
OpenBSD (Build from Port)
Download the port tarball
ftp https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-3.3.0.0-openbsd-port.tar.gz
Extract to ports tree
cd /usr/ports/sysutils
doas rm -rf sysmanage-agent
doas tar xzf ~/sysmanage-agent-3.3.0.0-openbsd-port.tar.gz
doas mv openbsd-port sysmanage-agent
Install Python dependencies (avoids gcc conflicts)
doas pkg_add py3-websockets py3-yaml py3-aiohttp py3-cryptography py3-sqlalchemy py3-alembic
Build and install
cd sysmanage-agent
doas make makesum
doas make install
Configure and start
doas cp /usr/local/share/examples/sysmanage-agent/sysmanage-agent.yaml /etc/sysmanage-agent.yaml
doas vi /etc/sysmanage-agent.yaml
doas rcctl enable sysmanage_agent
doas rcctl start sysmanage_agent
Checksum Verification
All packages include SHA256 checksums. Download both files and verify:
Linux (Ubuntu/CentOS/OpenSUSE/SLES):
sha256sum -c .sha256
macOS:
shasum -a 256 -c .sha256
Windows:
$expectedHash = (Get-Content ".sha256").Split()[0]
$actualHash = (Get-FileHash "" -Algorithm SHA256).Hash.ToLower()
if ($expectedHash -eq $actualHash) { Write-Host "Checksum verified!" } else { Write-Host "Checksum mismatch!" }
FreeBSD/NetBSD/OpenBSD:
sha256 -C .sha256
Alpine Linux:
sha256sum -c .sha256
Supported Platforms
- Ubuntu: 22.04 LTS (Jammy), 24.04 LTS (Noble)
- Debian: 11 (Bullseye), 12 (Bookworm), 13 (Trixie)
- CentOS/RHEL: 9.x
- OpenSUSE: Tumbleweed, Leap 15.x
- SUSE Linux Enterprise Server (SLES): 15.x
- Alpine Linux: 3.19, 3.20, 3.21 (pre-built packages available)
- macOS: 12+ (Monterey and later)
- Windows: 10 (1809+), 11, Server 2019+ (x64 and ARM64)
- FreeBSD: 13.x, 14.x
- NetBSD: 10.x (tested on 10.1)
- OpenBSD: 7.8, 7.9 (pre-built packages available)
Software Bill of Materials (SBOM)
This release includes a comprehensive Software Bill of Materials (SBOM) file in CycloneDX JSON format for supply chain security and vulnerability analysis:
Standalone Download:
- sysmanage-agent-sbom.json - Complete inventory of Python dependencies
Download and inspect:
Download SBOM file
wget https://github.com/bceverly/sysmanage-agent/releases/download/v3.3.0.0/sysmanage-agent-sbom.json
View with jq (if installed)
cat sysmanage-agent-sbom.json | jq .
The SBOM file is compatible with vulnerability scanning tools (Grype, Trivy, Dependency-Track, Snyk, etc.) and provides complete transparency of all software dependencies.
What's Included
- System management agent service
- Platform-native service management (systemd/launchd/rc.d)
- Automatic user/group creation
- Example configuration files
- Certificate storage directory
- Sudoers configuration for system management (Linux only)
OpenBSD Package Checksums (SHA256)
Alpine Linux Package Checksums (SHA256)
a5bb1538522e665ae02d9aeaaadb5f44e93dc7acdfbf9cc2ed8510e5068ce7fb sysmanage-agent-3.3.0.0-alpine320.apk
688d062ded8ec8a2f166e9e7906d478f511a13135a9d74e154e7466b87b61148 sysmanage-agent-3.3.0.0-alpine321.apk
