# shm

> Self-Hosted Metrics (SHM) is an open-source telemetry server for self-hosted apps. Collects aggregate stats via cryptographic identities, stores in PostgreSQL.

- **Category:** Monitoring & observability
- **Licence:** AGPL-3.0
- **Latest version:** v1.2.7
- **Open source:** oss
- **Languages:** Go, JavaScript, HTML
- **Platforms:** Docker Compose
- **Tags:** Analytics, PostgreSQL, Dashboard, Privacy, Metrics, Privacy First, Sdk, Telemetry, Node.js, Docker, Go, Self Hosted, On Premise, Badges

## Description

Self-Hosted Metrics (SHM) is a privacy-first telemetry platform for developers who distribute self-hosted software and need visibility into adoption, versions, and usage. The server is a single Go binary with an embedded AlpineJS/Tailwind dashboard, deployed via Docker Compose alongside PostgreSQL. Client SDKs for Go and Node.js send signed JSON payloads over HTTPS using Ed25519 keys generated on first run; the server stores raw JSONB and dynamically builds KPI cards, tables, and graphs from whatever keys appear. Features include multi-app tracking, automatic GitHub star fetching, public SVG badges for READMEs, rate limiting, and DO_NOT_TRACK opt-out. The dashboard has no built-in authentication — operators must add a reverse proxy with basic auth or ForwardAuth. The main server is AGPL-3.0; the SDKs are MIT-licensed for easier embedding. Minimum resources are ~0.1 vCPU, 64 MB for the app plus 256 MB for PostgreSQL.

## Links

- [Homepage](https://github.com/kOlapsis/shm)
- [Website](https://self-hosted-metrics.com)
- [Docker](ghcr.io/kolapsis/shm)
- [GitHub Repository](https://github.com/kOlapsis/shm)
- [GitHub Discussions](https://github.com/kolapsis/shm/discussions)
- [Deployment Guide](https://raw.githubusercontent.com/kOlapsis/shm/main/docs/DEPLOYMENT.md)
- [Go SDK](https://github.com/kolapsis/shm/tree/main/sdk/golang)
- [Node.js SDK (npm)](https://www.npmjs.com/package/@kolapsis/shm-sdk)

---
Source: https://selfhost.directory/project/shm