Self-hosting

import { Steps, Aside } from ‘@astrojs/starlight/components’;

Paisa is designed to self-host cheaply. The API runs on Cloudflare Workers (free tier handles personal use easily). The web app is a static Vite build — host it anywhere.

Prerequisites

A Cloudflare account (free)
A PostgreSQL database — Neon free tier works well
Bun installed locally

Steps

Clone the repo

git clone https://github.com/nimit9/paisa
cd paisa
bun install

Configure the API

Copy and fill in the environment variables:

cp apps/api/.env.example apps/api/.env

Required variables:

DATABASE_URL=postgresql://user:pass@host/db
BETTER_AUTH_SECRET=your-random-32-char-secret
WEB_URL=https://your-web-app-url.com
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...

Run migrations
Terminal window
```
bun run db:migrate
```

Deploy the API to Cloudflare Workers

cd apps/api
bunx wrangler deploy

Set secrets in Cloudflare:

bunx wrangler secret put DATABASE_URL
bunx wrangler secret put BETTER_AUTH_SECRET
# ... etc

Build and deploy the web app
Terminal window
```
cd apps/web
VITE_API_URL=https://your-worker.workers.dev bun run build
```
Deploy the dist/ folder to Cloudflare Pages, Vercel, or any static host.
Whitelist your email

Paisa uses Google OAuth with an email whitelist. Add your email in apps/api/src/auth.ts or configure the ALLOWED_EMAILS env var.

Cron jobs

The API includes Cloudflare cron triggers:

Schedule	Job
`0 1 * * *`	Zerodha portfolio sync
`0 0 1 * *`	Monthly report generation

These run automatically once deployed to Cloudflare Workers.