Skip to content

v1.0.2.0

Choose a tag to compare

@github-actions github-actions released this 16 Jan 14:55
· 698 commits to main since this release

SysManage Agent v1.0.2.0

Fixed unit test failures

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/v1.0.2.0/sysmanage-agent_1.0.2.0-1_amd64.deb
sudo apt install ./sysmanage-agent_1.0.2.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/v1.0.2.0/sysmanage-agent-1.0.2.0.flatpak
flatpak install --user sysmanage-agent-1.0.2.0.flatpak

CentOS/RHEL 9

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

# For Alpine 3.20:
# wget https://github.com/bceverly/sysmanage-agent/releases/download/v1.0.2.0/sysmanage-agent-1.0.2.0-alpine320.apk
# doas apk add --allow-untrusted sysmanage-agent-1.0.2.0-alpine320.apk

# For Alpine 3.19:
# wget https://github.com/bceverly/sysmanage-agent/releases/download/v1.0.2.0/sysmanage-agent-1.0.2.0-alpine319.apk
# doas apk add --allow-untrusted sysmanage-agent-1.0.2.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.4, 7.5, 7.6, or 7.7)
# For OpenBSD 7.7:
ftp https://github.com/bceverly/sysmanage-agent/releases/download/v1.0.2.0/sysmanage-agent-1.0.2.0-openbsd77.tgz
doas pkg_add sysmanage-agent-1.0.2.0-openbsd77.tgz

# For OpenBSD 7.6:
# ftp https://github.com/bceverly/sysmanage-agent/releases/download/v1.0.2.0/sysmanage-agent-1.0.2.0-openbsd76.tgz
# doas pkg_add sysmanage-agent-1.0.2.0-openbsd76.tgz

# For OpenBSD 7.5:
# ftp https://github.com/bceverly/sysmanage-agent/releases/download/v1.0.2.0/sysmanage-agent-1.0.2.0-openbsd75.tgz
# doas pkg_add sysmanage-agent-1.0.2.0-openbsd75.tgz

# For OpenBSD 7.4:
# ftp https://github.com/bceverly/sysmanage-agent/releases/download/v1.0.2.0/sysmanage-agent-1.0.2.0-openbsd74.tgz
# doas pkg_add sysmanage-agent-1.0.2.0-openbsd74.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/v1.0.2.0/sysmanage-agent-1.0.2.0-openbsd-port.tar.gz

# Extract to ports tree
cd /usr/ports/sysutils
doas rm -rf sysmanage-agent
doas tar xzf ~/sysmanage-agent-1.0.2.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 <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.4, 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/v1.0.2.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)

27a811cb86bfee70209824230dac706ed6c456177a66810627b4061025135963  sysmanage-agent-1.0.2.0-openbsd74.tgz
056a95fcab14fbc5d2886462482992efba258207821d01f4f26b76ad71440f40  sysmanage-agent-1.0.2.0-openbsd75.tgz
8c7ad88040b82d5a8deef16cae529a0eff7544a4101586e36e390c929fc57e62  sysmanage-agent-1.0.2.0-openbsd76.tgz
dc5e7f6c504a921a825d6743c2a924e9dfea8fb6f620dfd0576bb5a7d9bf5a2c  sysmanage-agent-1.0.2.0-openbsd77.tgz

Alpine Linux Package Checksums (SHA256)

855f1ad544fb7aa24a0a9a75c5a903bfb385b3256dbb1364ecdf3fea956a366c  sysmanage-agent-1.0.2.0-alpine319.apk
91c253e0c4b27bf8b03a591d448e0615c5a0ebdf8faf3b737638ec69530f780e  sysmanage-agent-1.0.2.0-alpine320.apk
ac367c70b41d50090e27070cad2141450ea535e2b22922204d9d23b050d59f44  sysmanage-agent-1.0.2.0-alpine321.apk