OpenBitum docs

Self-hosted alternative to Clerk + Polar.sh with native crypto payments. One Docker stack — identity, payments, entitlements, dashboard.

Quickstart →GitHub ↗

Tutorials

Step-by-step walkthroughs of the most common end-to-end flows.

15 min
Add SSO to your site and manage users

Register as an admin, create a Logto application for your external site, wire the OIDC handshake in Next.js (or any framework), and learn the ways to manage the users that result.

5 min
Put something up for sale

Configure a receiving wallet, pick an entitlement type (GitHub repo / Discord role / file / Logto role / webhook), create a product, and run the checkout with a real crypto invoice.

10 min
Multi-merchant + demo mode

Run multiple merchants on one install. Use the demo_mode flag to auto-pay invoices 5 seconds after creation — same flow as our live demo stands.

case study
Case study — Controlum integration

Real-world walkthrough: a Next.js + Go SaaS swapped its magic-link auth for OpenBitum SSO. End-to-end patches with Logto application creation, web @logto/next routes, Go JWKS middleware.

Live demo stands

Two storefronts on prod, powered by this exact OpenBitum install. Click around — no real crypto needed.

shop.openbitum.pw →
Vercel Commerce skin, OpenBitum backend. Browse, click Buy, watch the order flip to paid in 5 s.
demo.openbitum.pw →
Vercel SaaS Starter, Logto-backed sign-in, crypto-checkout subscriptions.
How they're wired →
demo_mode flag, simulate-paid worker, e2e specs, all the source files.

Getting started

Quickstart →
Working instance with one paid product in under 10 minutes.
Install options →
One-line curl, manual Docker compose, or Render blueprint.
Supported chains →
BTC, ETH, Base, Arbitrum, Solana. Mainnet and testnet.
API reference →
Glue REST surface and Logto management API endpoints.

Integrations

What the buyer gets when payment is confirmed.

GitHub invite →
Collaborator invite to a private repo. PAT or GitHub App.
Discord role →
Bot grants a role on payment confirmation.
File download →
One-time signed S3/MinIO URL, scoped to the buyer.
Logto role →
Assign IDM roles to paying users automatically.
Webhook →
Signed POST to your own service. Handle the side effect yourself.

Reference

Troubleshooting →
Stuck orders, OIDC pitfalls, missing entitlements.
API →
Full REST surface for programmatic checkout and order management.

Under the hood

A single docker-compose.yml brings up Postgres + Redis + MinIO + Logto + Bitcart + Caddy. Your Next.js app and a Fastify glue service sit on top: the glue receives Bitcart webhooks, runs entitlement handlers with retries, and exposes the merchant and checkout API. Caddy handles auto-SSL via Let's Encrypt.

Licensed AGPL-3.0. Commercial licenses available for cases where AGPL doesn't fit.