Guides and updates
9 postsPractical walkthroughs and product notes from the Rekey team: how to run the operator panel, billing recipes, and the context behind what ships in the changelog.
- Guide · · 9 min
Two role systems, and which one you want
Rekey has an application role and an organization role, and picking the wrong one returns a plausible answer forever. What each is for, the use cases that call for one value per user versus one per team, how to define your own names like editor or content-manager, and the field to gate your features on.
- Starter kit · · 6 min
A Next.js starter with auth and billing already wired up
Clone it and you have sign-up, sign-in, sessions, a pricing page fed by real plans, hosted checkout, entitlements and credits. Every part of the integration is a short file you can read and delete, including the middleware bug we shipped and then fixed.
- Starter kit · · 6 min
An Astro starter, and what writing it taught us about our own SDK
Sessions, checkout and entitlements in Astro with no JavaScript shipped. Includes the ninety-line session adapter in full, why the Secure flag is decided per request, and the reason React left the project entirely.
- Starter kit · · 5 min
A shop where what you own is an entitlement, not a row
A digital storefront on Next.js and SQLite. The catalogue is a file, who paid is Rekey, and the app opens the database read-only so it cannot write an ownership fact. Why there is no cart, and the one route where getting the check wrong costs money.
- Guide · · 6 min
Use one Rekey Application to sign users in to another
An Application can act as an OpenID Connect provider, so another product offers Sign in with it and your users keep one account. Here is the whole flow: the discovery document, registering a client, why there is no client secret, and the one setting that decides whether you get an email claim.
- Guide · · 5 min
When to use organizations, and how
Organizations group end-users into teams that share one subscription. Useful when a company buys for its staff, wrong when your product is bought by individuals. What they change about billing and entitlements, and the calls to create one and invite people.
- Engineering · · 8 min
One directory per payment provider
A month of hardening, honestly told: the audit that caught our webhook handlers half-committing, the focus rings that compiled to nothing, four portal dead-ends, and the provider-module system that turned adding a payment processor from sixteen scattered edits into a single directory.
- Guide · · 8 min
Self-hosting Rekey: Docker Compose & Dokploy
Run the whole Rekey stack yourself, API, operator panel, Postgres, and Redis. A two-path guide: a one-command Docker Compose boot, and a click-through Dokploy deploy with automatic HTTPS, plus the env vars and production checklist.
- Guide · · 14 min
How to use the Rekey operator panel
An end-to-end walkthrough of the operator console: create an Application, mint API keys, configure auth, build plans and coupons, connect a billing provider, and run the day-to-day, revenue, end-users, webhooks, usage, team roles, and the audit log.
Looking for reference material instead? Read the docs.