oslks-telemetry

OSLKS Radar provides a high‑performance, privacy‑friendly solution for tracking website traffic. The backend collector is written in Rust using the Axum framework and stores events in TimescaleDB, delivering O(1) origin validation via an in‑memory cache and supporting millions of requests per second. The frontend is a React single‑page application built with Vite and Shadcn UI, offering a modern glass‑morphism design, dark‑mode, and full PWA capabilities. Key features include: - Ultra‑fast ingestion on port 8080, with optional stealth mode routes to bypass ad‑blockers. - Real‑time dashboards on port 3000, displaying pageviews, SPA navigation events, and geographic data (optional MaxMind GeoIP). - Privacy‑first operation: no cookies, no third‑party scripts, GDPR‑compatible, and fully self‑hosted. - ARM‑compatible binaries for low‑resource environments such as Ampere instances. - Simple installation via a single Docker image that runs the collector, a Node API, and a Caddy server, orchestrated with s6‑overlay. Docker‑Compose also provisions a TimescaleDB container. - Comprehensive site management, API keys for server‑to‑server access, and an installation wizard for initial super‑user setup. Integration is done by adding a tiny <1KB script tag to the page head, specifying the website UUID and the collector URL. The collector enforces a CORS whitelist, requiring each domain to be listed in CORS_ALLOWED_ORIGINS. Deployment can be performed with Docker Compose on any VPS, Coolify, or similar platform. Environment variables control database connection, session secret, allowed origins, and optional GeoIP database path. The VITE_* variables are baked into the SPA at build time. The project is open source under the MIT license and welcomes contributions via fork‑and‑pull‑request workflow.