telemetry-server

Documentation

Overview

telemetry-server is a tiny HTTP service that counts active Bindery installs. It accepts anonymous pings from Bindery instances and returns the latest published version so clients can surface an update badge.

Endpoints:

GET  /               — welcome page with logo and GitHub link
GET  /stats          — public dashboard with version/OS/arch charts
GET  /stats.json     — public JSON snapshot {active,total,latest} for bots
POST /api/ping       — upsert install record, return latest version (rate-limited)
GET  /api/stats      — active/total counts + version breakdown (token-gated)
GET  /api/backup     — sqlite VACUUM INTO snapshot of installs DB (token-gated)
GET  /health         — liveness probe