Skip to content

Reference

Deep dives on the internals: how the three containers fit together, every environment variable, the full REST API surface, the security model, and the usual troubleshooting recipes.

Architecture

Three containers, two SQLite writers, one shared WAL DB. The bridge is strictly read-only. Every byte that crosses the network boundary is shown.

Configuration

Every environment variable, what it does, what the default is, and when to tune it.

Observability

Optional OpenTelemetry metrics: how to enable them, every metric name, and what is never exported.

REST API

Every endpoint, request shape, response shape, and required role.

Security & privacy

What's on disk, what's not, how bcrypt + opaque bearer tokens work, and the read-only bridge contract.

FAQ

Common questions and answers.

Troubleshooting

Common gotchas and how to fix them.

A note on the docs vs the code

The docs are hand-curated from the source — they're not auto-generated. If you spot a drift between the docs and the code, please open an issue.