Skip to main content

SHM

1-Click installation template for SHM on Easypanel

Description

SHM (Self-Hosted Metrics) is privacy-first, agnostic telemetry for self-hosted software—collect usage stats, verify active instances, and understand adoption without spying on users. Instances sign payloads with Ed25519; PostgreSQL stores JSON metrics behind a single Go binary with an embedded dashboard (port 8080). AGPL-3.0; upstream lives under the kOlapsis GitHub organization.

Benefits

  • Privacy-first telemetry: Aggregate counters and signed snapshots—no user content; built for self-hosted product owners who need adoption insight.
  • Agnostic payloads: Send JSON metrics; the dashboard adapts with dynamic KPIs and tables.
  • PostgreSQL backend: Stores payloads in PostgreSQL via SHM_DB_DSN; Easypanel provisions a postgres service.
  • Embedded UI: Single container serves API and dashboard on port 8080.

Features

  • Ed25519 instance identity: Cryptographic registration and signed snapshots reduce spoofing.
  • Multi-app tracking: Track several products on one SHM server.
  • Badges & GitHub stars: Optional embeddable badges and GitHub star integration when configured.
  • SDKs: Go and Node clients for integrating telemetry into your apps.

Options

NameDescriptionRequiredDefault Value
App Service Name-yesshm
App Service Image-yesghcr.io/kolapsis/shm:sha-fd3affa

Screenshots

SHM Screenshot

Change Log

  • 2025-01-29 – Initial Template Release

Contributors

Subscribe for product updates

By subscribing, you agree with our Terms and Privacy Policy.