vantezzen/pay
Self-host

Self-host vantezzen/pay

Run vantezzen/pay on your own domain with your own database and provider accounts.

Self-hosting vantezzen/pay means running the Next.js app, the provider service, and Postgres. Your users still check out through Stripe or Polar; vantezzen/pay handles products, wallets, credits, webhooks, and the shadcn registry.

What you need

  • A public domain for vantezzen/pay, for example https://pay.example.com.
  • A Postgres database.
  • Environment variables for auth, provider-service access, provider-service secret storage, and public URLs.
  • Stripe or Polar credentials.

For a local first run, install dependencies and run bun run setup. It creates both environment files with matching local secrets and refuses to overwrite existing configuration. Then review the files and continue below.

  1. Set environment variables.
  2. Create and migrate Postgres.
  3. Deploy the provider service.
  4. Deploy the Next.js app.
  5. Connect Stripe or Polar - provider setup is the same for hosted and self-hosted instances.
  6. Use your registry URL.
  7. Follow operational checks.

After creating your admin account, set PAY_ALLOW_SIGNUPS=false unless you want other developers to create accounts on your instance.