SysManage Agent

SysManage · sysmanage.sysmanage-agent

Cross-platform system management agent for SysManage.

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.

winget install --id sysmanage.sysmanage-agent --exact --source winget

Latest 2.4.0.32

Release Notes

SysManage Agent v2.4.0.32 Fixed failed tests 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/v2.4.0.32/sysmanage-agent_2.4.0.32-1_amd64.deb sudo apt install ./sysmanage-agent_2.4.0.32-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/v2.4.0.32/sysmanage-agent-2.4.0.32.flatpak flatpak install --user sysmanage-agent-2.4.0.32.flatpak CentOS/RHEL 9

Download and install

wget https://github.com/bceverly/sysmanage-agent/releases/download/v2.4.0.32/sysmanage-agent-2.4.0.32-1.el9.x86_64.rpm sudo dnf install ./sysmanage-agent-2.4.0.32-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/v2.4.0.32/sysmanage-agent-2.4.0.32-1.opensuse.tumbleweed.x86_64.rpm sudo zypper install ./sysmanage-agent-2.4.0.32-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/v2.4.0.32/sysmanage-agent-2.4.0.32-1.opensuse.leap.15.x86_64.rpm sudo zypper install ./sysmanage-agent-2.4.0.32-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/v2.4.0.32/sysmanage-agent-2.4.0.32-1.sles.x86_64.rpm sudo zypper install ./sysmanage-agent-2.4.0.32-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/v2.4.0.32/sysmanage-agent-2.4.0.32-macos.pkg sudo installer -pkg sysmanage-agent-2.4.0.32-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/v2.4.0.32/sysmanage-agent-2.4.0.32-windows-x64.msi" -OutFile "sysmanage-agent-2.4.0.32-windows-x64.msi" Start-Process msiexec.exe -ArgumentList "/i sysmanage-agent-2.4.0.32-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/v2.4.0.32/sysmanage-agent-2.4.0.32-windows-arm64.msi" -OutFile "sysmanage-agent-2.4.0.32-windows-arm64.msi" Start-Process msiexec.exe -ArgumentList "/i sysmanage-agent-2.4.0.32-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/v2.4.0.32/sysmanage-agent-2.4.0.32.pkg sudo pkg add sysmanage-agent-2.4.0.32.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/v2.4.0.32/sysmanage-agent-2.4.0.32.tgz sudo pkg_add sysmanage-agent-2.4.0.32.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/v2.4.0.32/sysmanage-agent-2.4.0.32-alpine321.apk doas apk add --allow-untrusted sysmanage-agent-2.4.0.32-alpine321.apk

For Alpine 3.20:

wget https://github.com/bceverly/sysmanage-agent/releases/download/v2.4.0.32/sysmanage-agent-2.4.0.32-alpine320.apk

doas apk add --allow-untrusted sysmanage-agent-2.4.0.32-alpine320.apk

For Alpine 3.19:

wget https://github.com/bceverly/sysmanage-agent/releases/download/v2.4.0.32/sysmanage-agent-2.4.0.32-alpine319.apk

doas apk add --allow-untrusted sysmanage-agent-2.4.0.32-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.5, 7.6, or 7.7)

For OpenBSD 7.7:

ftp https://github.com/bceverly/sysmanage-agent/releases/download/v2.4.0.32/sysmanage-agent-2.4.0.32-openbsd77.tgz doas pkg_add sysmanage-agent-2.4.0.32-openbsd77.tgz

For OpenBSD 7.6:

ftp https://github.com/bceverly/sysmanage-agent/releases/download/v2.4.0.32/sysmanage-agent-2.4.0.32-openbsd76.tgz

doas pkg_add sysmanage-agent-2.4.0.32-openbsd76.tgz

For OpenBSD 7.5:

ftp https://github.com/bceverly/sysmanage-agent/releases/download/v2.4.0.32/sysmanage-agent-2.4.0.32-openbsd75.tgz

doas pkg_add sysmanage-agent-2.4.0.32-openbsd75.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/v2.4.0.32/sysmanage-agent-2.4.0.32-openbsd-port.tar.gz

Extract to ports tree

cd /usr/ports/sysutils doas rm -rf sysmanage-agent doas tar xzf ~/sysmanage-agent-2.4.0.32-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), 24.10 (Oracular), 25.04 (Plucky), 25.10 (Questing)
  • 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.5, 7.6, 7.7 (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/v2.4.0.32/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) 789f5214873033f5e7ac1f6e813e980ed47a1778c0c8594f5e9427f68e6145de sysmanage-agent-2.4.0.32-openbsd77.tgz Alpine Linux Package Checksums (SHA256) 5130a20ded4dd9e75963e0494ed127513d900fcb1093a8a0eb679afc868722f1 sysmanage-agent-2.4.0.32-alpine320.apk ee7d6e7b4f621c118c00a0eac0c43317d3741cd701363cc5054c1a6c6e70d98e sysmanage-agent-2.4.0.32-alpine321.apk

Installer type: wix

Architecture Scope Download SHA256
x64 Download AEC2C9F8A290369853B0FC58C5AE454D25232DBC4CB91A54FB6F9AE4C5ED1995

Details

Homepage
https://github.com/bceverly/sysmanage-agent
License
AGPL-3.0-or-later
Publisher
SysManage
Support
https://github.com/bceverly/sysmanage-agent/issues
Copyright
Copyright (c) Bryan Everly
Moniker
sysmanage-agent

Older versions (2)

2.4.0.30
Architecture Scope Download SHA256
x64 Download 8B55EA9EA98F944ED598FDEBF0DC3D00275353835719D3BF69A01989626C4547
2.3.0.19
Architecture Scope Download SHA256
x64 Download 3DB62D001A97CA09B65D364395BF18D1C19796CE370BE7BFC37845A099C5BF5E
arm64 Download FF6D4D17E39AA0CB90CB6015B99BAB65FBE569828FCF6152AEE361A7B201A3B7