Overview
Self-hosted Buckle (Community and Enterprise) sends no telemetry to Buckle or any third party. There is nothing to opt out of. The only analytics in the codebase are product analytics for Buckle Cloud, and they stay off unless the deployment explicitly configures them.Self-hosted deployments
The gateway contains one analytics sink, and it is disabled unless bothPOSTHOG_API_KEY and POSTHOG_HOST are set in the gateway’s environment. Neither variable has a default, the self-hosted Docker Compose file doesn’t set them, and the images don’t bake them in. A key without a host is also treated as off.
The web dashboard works the same way: its analytics only initialize when NEXT_PUBLIC_POSTHOG_KEY and NEXT_PUBLIC_POSTHOG_HOST are set at build time, which self-hosted builds don’t do.
Self-hosted Buckle still records request activity in your own PostgreSQL database (the
request_logs table behind the Activity page). That data never leaves your environment.Buckle Cloud
On Cloud, the gateway sends aninjection event to PostHog for each request where it injected a credential. Each event carries:
Events are buffered and sent in batches every 5 seconds (or every 500 events), off the request path, so they add no latency.
What is never collected
- Secret or credential values
- Request or response bodies
- Database query text (it can appear in your own activity log, but is never sent to analytics)
How it works
Telemetry lives in the gateway, in thetelemetry crate. It starts when the gateway starts and runs one background loop that:
- Writes request activity to your PostgreSQL database (every edition).
- Sends
injectionevents to PostHog, only whenPOSTHOG_API_KEYandPOSTHOG_HOSTare both set. - Updates usage counters and budget spend in your cache and database.