FreeBeamer Auth

Tuner account service: username + password (argon2id) login, session issuance, and the introspection endpoint dependent services (e.g. Garage) use to resolve who's calling. Nothing else — it doesn't know about vehicles, maps, or telemetry.

Warning

Experimental software.

See deployment instructions.

Development

go test ./...
go vet ./...
go build -o bin/freebeamer-auth ./cmd/freebeamer-auth

Create a local tuner account and run the service:

go run ./cmd/freebeamer-auth tuner create --username shop1 --db dev.sqlite
go run ./cmd/freebeamer-auth serve --db dev.sqlite

API

Method/Path	Auth	Purpose
POST /v1/login	none	{username, password} → {session_token, expires_at}.
POST /v1/logout	tuner session	Revokes the presented session immediately.
POST /v1/introspect	tuner session	{tuner_id, username, expires_at} — what a dependent service calls to resolve a caller's identity.
GET /healthz	none	Liveness check.

Related projects

• Core — Go libraries for ECU calibration formats, binary editing, checksums, vehicle profiles, and telemetry contracts.
• CLI — Command-line tools for inspecting calibration files, reviewing binary changes, verifying checksums, and collecting experimental live data.
• Desktop — Experimental ECU calibration editor and live-data viewer built with Go, Wails, Angular, and Plotly.
• Relay — Self-hosted Go telemetry relay with authenticated ingestion, SQLite storage, session history, and WebSocket live feeds.
• Mobile — Experimental Flutter companion for read-only MHD/ENET live-data acquisition and upload to a FreeBeamer telemetry relay.

Contributing and license

See CONTRIBUTING.md. Source is licensed under MIT.