Skip to content

v2.4.0.32

Choose a tag to compare

View all tags
@github-actions github-actions released this 10 Jun 20:27
· 4 commits to main since this release
v2.4.0.32
85af4b0

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 <package>.sha256

macOS:

shasum -a 256 -c <package>.sha256

Windows:

$expectedHash = (Get-Content "<package>.sha256").Split()[0]
$actualHash = (Get-FileHash "<package>" -Algorithm SHA256).Hash.ToLower()
if ($expectedHash -eq $actualHash) { Write-Host "Checksum verified!" } else { Write-Host "Checksum mismatch!" }

FreeBSD/NetBSD/OpenBSD:

sha256 -C <package>.sha256 <package>

Alpine Linux:

sha256sum -c <package>.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
Assets 43
Loading