0.4.2

What's changed

• Replace the dashboard text mark with the Keryx Dispatch logo by @prom3theu5 in #7
• Bump the Keryx version to 0.4.2 by @prom3theu5 in #8

Full changelog: 0.4.1...0.4.2

---

Highlights

Keryx 0.4.2 replaces the dashboard's Greek letter placeholder with the new Dispatch logo. The generated SVG has a 24 mm square canvas and uses the existing dashboard blue palette.

Upgrade

No manual data migration is required. Replace the binary and restart keryx serve.

Install

Binaries are attached below for three targets. If yours is not one of them, build from source. The release archives also include the README, licence, and ready-made Keryx agent skills.

Platform	Asset
Linux, x86-64 (glibc 2.35+)	keryx-0.4.2-x86_64-unknown-linux-gnu.tar.gz
macOS, Apple Silicon	keryx-0.4.2-aarch64-apple-darwin.tar.gz
Windows, x86-64	keryx-0.4.2-x86_64-pc-windows-msvc.zip

Linux (x86-64)

gh release download 0.4.2 --repo SimCubeLtd/keryx \
  --pattern 'keryx-0.4.2-x86_64-unknown-linux-gnu.tar.gz*'

sha256sum -c keryx-0.4.2-x86_64-unknown-linux-gnu.tar.gz.sha256
tar -xzf keryx-0.4.2-x86_64-unknown-linux-gnu.tar.gz

sudo install -m755 keryx-0.4.2-x86_64-unknown-linux-gnu/bin/keryx /usr/local/bin/
keryx --version

For a single-user install with no sudo, use ~/.local/bin instead and make sure it is on your PATH.

macOS (Apple Silicon)

gh release download 0.4.2 --repo SimCubeLtd/keryx \
  --pattern 'keryx-0.4.2-aarch64-apple-darwin.tar.gz*'

shasum -a 256 -c keryx-0.4.2-aarch64-apple-darwin.tar.gz.sha256
tar -xzf keryx-0.4.2-aarch64-apple-darwin.tar.gz

sudo install -m755 keryx-0.4.2-aarch64-apple-darwin/bin/keryx /usr/local/bin/
keryx --version

The binary is not code-signed or notarised. Downloading through a browser can attach a quarantine flag and cause Gatekeeper to refuse it. Clear the flag once with:

xattr -d com.apple.quarantine /usr/local/bin/keryx

Intel Macs do not have a native binary. Build from source, or run the Apple Silicon build under Rosetta 2. Rosetta 2 is unsupported and untested for this release.

Windows (x86-64)

Run these commands in PowerShell:

gh release download 0.4.2 --repo SimCubeLtd/keryx `
  --pattern 'keryx-0.4.2-x86_64-pc-windows-msvc.zip*'

# Compare the archive against the published checksum.
Get-FileHash keryx-0.4.2-x86_64-pc-windows-msvc.zip -Algorithm SHA256
Get-Content keryx-0.4.2-x86_64-pc-windows-msvc.zip.sha256

Expand-Archive keryx-0.4.2-x86_64-pc-windows-msvc.zip -DestinationPath $env:LOCALAPPDATA\Programs

$dir = "$env:LOCALAPPDATA\Programs\keryx-0.4.2-x86_64-pc-windows-msvc\bin"
[Environment]::SetEnvironmentVariable(
  'Path', [Environment]::GetEnvironmentVariable('Path','User') + ";$dir", 'User')

Open a new terminal, then run keryx --version.

The executable is unsigned, so SmartScreen can warn on first run. The installation does not require administrator rights.

Build from source (any platform)

Install the pinned Rust nightly toolchain, then run:

rustup toolchain install nightly-2026-08-20 --profile minimal
git clone --branch 0.4.2 --depth 1 https://github.com/SimCubeLtd/keryx.git
cd keryx
cargo +nightly-2026-08-20 build --release --locked
./target/release/keryx --version

To install the tagged release into ~/.cargo/bin, run:

cargo +nightly-2026-08-20 install --git https://github.com/SimCubeLtd/keryx \
  --tag 0.4.2 --locked keryx

--locked uses the dependency versions in the committed Cargo.lock.