Self-host|MIT · Docker
Run ityourself.
CorpoPay is MIT-licensed and deployable to any Node host. One command with Docker — migrations and seed included.
Prerequisites
What you need.
Node 24+
The API runs on modern Node — Express + Prisma + Inngest.
Docker
Compose brings up the API and the Inngest dev server.
PostgreSQL
The double-entry ledger lives in Postgres, managed by Prisma.
Quickstart
Three commands to a running stack.
01
Configure
Copy the environment template and fill in your secrets.
02
Boot
Compose builds the API and runs migrations plus the seed.
03
Charge
Create a payment intent — money posts to the ledger, balanced.
docker
cp .env.example .env
docker compose up --buildAPI on :4000 · Inngest dev server on :8288. Migrations and seed run automatically.
Production
A packaged image.
A multi-arch, Trivy-scanned image is published to ghcr.io on every release. Point it at your Postgres and go.
ghcr.io/corpopay/corpopay-api
Key environment variables
Secrets come from environment variables only — never hardcode them.
DATABASE_URLPostgreSQL connection stringJWT_SECRETAuth signing secretENCRYPTION_KEY32-byte hex — AES-256-GCMINNGEST_EVENT_KEYEvent + signing keys for jobsAPI_BASE_URLPublic API URL (webhooks)WEB_BASE_URLPublic web URL (checkout)