Plugin Store · Store
Shared, durable, multi-node.
Overview
The Postgres store is the multi-node answer: one database behind a cluster of Busbar nodes, so virtual keys, usage, and the audit trail are shared across the whole fleet instead of siloed per node.
It keeps the same discipline as the other stores: each node enforces against fast in-memory counters and treats Postgres as the durable, shared truth it reconciles spend into. To be precise about what that buys: keys, usage, and audit are cluster-shared, while the hard budget cap is enforced per node and reconciled durably, so the shared record reflects the true fleet total without a database read on the hot path.
It implements the same Store contract the Memory and SQLite stores do.
Install it
Download the signed tarball for your platform (button above), drop it in plugins/, and set:
store:
module: postgres
settings: { url: "postgres://user:pass@host:5432/busbar" }Independently versioned from busbar itself: pin both explicitly in production. Requires busbar 1.5.0+.
Prefer to install by hand? No plugins.fetch config needed: download the signed tarball (links above), drop it in your plugins.dir, and busbar loads it at boot; signature and trust checks still apply. You can also push it live over the admin API. See the plugin install docs.
Settings
| Setting | Required | Default | Description |
|---|---|---|---|
url | Yes | — | libpq/DSN connection string, e.g. postgres://user:pass@host:5432/busbar. Connects without TLS; add ?connect_timeout=N to bound the connect. |