Tenarium documentation
Tenarium is an open-source tenant control plane for multi-tenant SaaS applications. It owns the tenant lifecycle (create, provision, suspend, delete), plans and entitlements, users, members and usage quotas, records every change in a durable event log, and lets plugins take part in all of it. The README has the quick start.
┌───────────── Tenarium ─────────────────────────────────────────┐
REST API ─▶│ authn ─▶ authz ─▶ hooks ─▶ [ tx: state + event (outbox) ] │
Admin UI │ │ │
│ dispatcher (cursor, retry, DLQ, leases) │
└──────────┬───────────────┬───────────────┬─────────────────────┘
▼ ▼ ▼
provisioning Kafka / your plugins
(schema, realm, …) webhooks (Go · HTTP · WASM)
Using Tenarium
| Page | Covers |
|---|---|
| Configuration | every configuration key and its default |
| REST API | resources, errors, concurrency, idempotency, pagination |
| Tenant lifecycle | templates, cloning, scheduled actions, maintenance windows, soft deletion, custom domains, branding, API keys, health scores, usage periods, SCIM, audit |
| Plans and placement | entitlements, plan revisions, add-ons, feature rollouts, regions |
| Users | directories, sign-in, sign-in links, email change, sessions, roles, two-factor authentication, passkeys, impersonation |
| Authentication and authorization | authenticators, actions, tenant roles and groups, OIDC and SAML SSO, social login, signing keys |
| OpenID provider | Tenarium as the sign-in service of your applications |
| Tenant webhooks | self-service webhooks with Standard Webhooks signatures |
| Event schema registry | JSON Schemas of every event type and their versioning |
| Data protection | exports, user erasure, purging deleted tenants |
Integrating your application
| Page | Covers |
|---|---|
| Go client and tenariumctl | the API client and the CLI |
| Tenant middleware | resolving and checking tenants in Go, TypeScript and Python services |
| Gateway integration | tenant resolution at the API gateway |
| PostgreSQL row-level security | isolating tenants in a shared database |
Plugins
Plugins lists every built-in plugin and the extension points. Writing Go plugins, external plugins and WebAssembly plugins show how to write your own.
Running Tenarium
| Page | Covers |
|---|---|
| Operations | deployment, PostgreSQL, scaling, health, metrics, tracing, security checklist |
| TLS and managed certificates | HTTPS with a static certificate or ACME |
| Secrets at rest | KMS envelope encryption of stored secrets |
| Multi-region deployments | what works today and a recommended cell architecture |
| Architecture | domain model, events, delivery, hooks, package map |
| Testing | unit, integration, fuzz, load and chaos tests |
| Roadmap | what is done and what may come |